blacksmith — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер связывает ассистента с платформой Blacksmith CI. Он помогает разбирать сбои сборки, находить нестабильные тесты и проверять расходы на воркеры прямо в терминале.
claude mcp add blacksmith -e BLACKSMITH_ORG=<BLACKSMITH_ORG> -e BLACKSMITH_SESSION_COOKIE=<BLACKSMITH_SESSION_COOKIE> -- npx -y blacksmith-mcpЧто делает blacksmith
Инструмент подключает ИИ к сервису Blacksmith CI без постоянного переключения в браузер. Ассистент обращается к пайплайнам через готовый набор вызовов. Он умеет читать сырые логи задач через get_job_logs, фильтровать запуски с помощью list_runs и группировать упавшие тесты по шаблонам ошибок через get_failures_by_pattern. Также сервер сопоставляет результаты тестов в рабочей ветке и в main для поиска регрессий.
Помимо логов сервер отдаёт метрики инфраструктуры. Через get_current_usage и get_cache_stats агент проверяет занятые ядра процессора, размеры кэша и биллинговые минуты. На macOS сессия подтягивается напрямую из профиля Chrome. Если браузер заблокирован или используется другая ОС, придётся передать значение куки в переменную BLACKSMITH_SESSION_COOKIE.
Сервер опирается на закрытое веб-API Blacksmith. Внешний интерфейс платформы может измениться без предупреждения. Для работы в обязательном порядке требуется указать имя организации в BLACKSMITH_ORG.
Какие задачи решает
- выяснить причины падения последнего прогона CI
- выявить нестабильные тесты за последнюю неделю
- сравнить ошибки в тестах между веткой PR и main
- отследить занятый объём кэша и лимиты ядер воркеров
Примеры запросов агенту
- Почему упал последний прогон CI в Blacksmith?
- Покажи нестабильные тесты за последние семь дней.
- Сравни упавшие тесты между веткой текущего PR и main.
Как установить blacksmith
Командой платформы
claude mcp add blacksmith -e BLACKSMITH_ORG=<BLACKSMITH_ORG> -e BLACKSMITH_SESSION_COOKIE=<BLACKSMITH_SESSION_COOKIE> -- npx -y blacksmith-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add blacksmith --env BLACKSMITH_ORG=<BLACKSMITH_ORG> --env BLACKSMITH_SESSION_COOKIE=<BLACKSMITH_SESSION_COOKIE> -- npx -y blacksmith-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"blacksmith": {
"command": "npx",
"args": [
"-y",
"blacksmith-mcp"
],
"env": {
"BLACKSMITH_ORG": "<BLACKSMITH_ORG>",
"BLACKSMITH_SESSION_COOKIE": "<BLACKSMITH_SESSION_COOKIE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"blacksmith": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"blacksmith-mcp"
],
"env": {
"BLACKSMITH_ORG": "<BLACKSMITH_ORG>",
"BLACKSMITH_SESSION_COOKIE": "<BLACKSMITH_SESSION_COOKIE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e BLACKSMITH_ORG=<BLACKSMITH_ORG> -e BLACKSMITH_SESSION_COOKIE=<BLACKSMITH_SESSION_COOKIE> blacksmith npx -y blacksmith-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о blacksmith
Как установить blacksmith в Claude Code?
Выполните в терминале команду claude mcp add blacksmith -e BLACKSMITH_ORG=<BLACKSMITH_ORG> -e BLACKSMITH_SESSION_COOKIE=<BLACKSMITH_SESSION_COOKIE> -- npx -y blacksmith-mcp.
Что делает MCP-сервер blacksmith?
Он предоставляет инструменты для анализа результатов CI, поиска причин падения тестов, проверки логов задач и контроля потребления вычислительных ресурсов в Blacksmith.
Как работает аутентификация в blacksmith?
На macOS сервер может автоматически извлечь сессию из Chrome при выполненном входе в app.blacksmith.sh. В остальных случаях требуется вручную задать переменную BLACKSMITH_SESSION_COOKIE.
