Gaffer — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер подключает ассистента к истории прогонов Gaffer. Агент проверяет нестабильные тесты, падения и покрытие кода прямо во время отладки.
claude mcp add --env GAFFER_API_KEY=<GAFFER_API_KEY> --env GAFFER_API_URL=<GAFFER_API_URL> --transport stdio gaffer -- npx -y @gaffer-sh/mcpЧто делает Gaffer
Сервер передаёт модели данные о качестве тестов из вашего аккаунта Gaffer. Он умеет группировать сбои по первопричинам, находить медленные проверки по перцентилю P95 и сопоставлять файлы с низким покрытием со свежими ошибками. Запись ограничена одной функцией upload_test_results, а остальные 16 аналитических функций работают только на чтение.
Вместо десятка отдельных инструментов протокола здесь работает «code mode». Сервер открывает три инструмента: execute_code, search_tools и list_projects. Модель пишет вызовы функций пространства codemode на JavaScript. В одном запуске действует ограничение на 20 обращений к API и таймаут 30 секунд.
Без аккаунта Gaffer с загруженными результатами тестов и токена GAFFER_API_KEY сервер не выдаст метрик. Список проектов станет доступен только при использовании пользовательского ключа с префиксом gaf_.
Какие задачи решает
- Найти нестабильные тесты с частыми сменами статуса
- Сгруппировать упавшие тесты по причинам сбоев
- Проверить файлы с низким покрытием и недавними ошибками
- Сравнить метрики прогона тестов между коммитами
Примеры запросов агенту
- Проверь здоровье тестового набора в проекте и покажи самые нестабильные тесты
- Сравни результаты тестов между последними двумя коммитами
- Покажи файлы с низким покрытием, где недавно падали проверки
Как установить Gaffer
Командой платформы
claude mcp add --env GAFFER_API_KEY=<GAFFER_API_KEY> --env GAFFER_API_URL=<GAFFER_API_URL> --transport stdio gaffer -- npx -y @gaffer-sh/mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add gaffer --env GAFFER_API_KEY=<GAFFER_API_KEY> --env GAFFER_API_URL=<GAFFER_API_URL> -- npx -y @gaffer-sh/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"gaffer": {
"command": "npx",
"args": [
"-y",
"@gaffer-sh/mcp"
],
"env": {
"GAFFER_API_KEY": "<GAFFER_API_KEY>",
"GAFFER_API_URL": "<GAFFER_API_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"gaffer": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@gaffer-sh/mcp"
],
"env": {
"GAFFER_API_KEY": "<GAFFER_API_KEY>",
"GAFFER_API_URL": "<GAFFER_API_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e GAFFER_API_KEY=<GAFFER_API_KEY> -e GAFFER_API_URL=<GAFFER_API_URL> gaffer npx -y @gaffer-sh/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Gaffer
Как установить Gaffer в Claude Code?
Выполните команду claude mcp add --env GAFFER_API_KEY=<GAFFER_API_KEY> --env GAFFER_API_URL=<GAFFER_API_URL> --transport stdio gaffer -- npx -y @gaffer-sh/mcp. Для работы потребуется действующий ключ API сервиса Gaffer.
Что делает MCP-сервер Gaffer?
Сервер открывает ИИ-агенту доступ к базе данных тестовых прогонов. Модель может анализировать историю сбоев, вычислять процент успешных запусков и просматривать отчёты о покрытии.
Чем архитектура code mode отличается от обычных MCP-серверов?
Вместо регистрации 17 отдельных инструментов сервер предоставляет три: поиск методов, запуск кода и список проектов. Ассистент объединяет нужные вызовы в один скрипт JavaScript с лимитом 30 секунд на выполнение.
