agy-bridge — MCP-сервер для Claude Code: что делает и как установить
Отдаёт тяжёлые задачи из Claude Code в Antigravity CLI и возвращает только ответ. Пригодится, когда лог или история git не влезают в контекст.
claude mcp add --env AGY_PATH=<AGY_PATH> --env AGY_TIMEOUT=<AGY_TIMEOUT> --env AGY_MAX_OUTPUT_CHARS=<AGY_MAX_OUTPUT_CHARS> --env AGY_DEFAULT_MODEL=<AGY_DEFAULT_MODEL> --env AGY_ON_FAILURE=<AGY_ON_FAILURE> --transport stdio agy-bridge -- npx -y agy-bridgeЧто делает agy-bridge
MCP-сервер agy-bridge передаёт работу из Claude Code в Antigravity CLI (agy), а назад отдаёт один результат. Крупные файлы, поиск по истории git и справки из документации не занимают контекст Claude. Внутри 6 инструментов: analyze_files для больших файлов и логов, deep_search для git log и git blame, web_lookup для внешних источников, adversarial_review для критики планов и кода, delegate для остального и follow_up для продолжения сессии по session_id.
Модель подбирается под инструмент. При первом вызове сервер запускает agy models, кеширует список на всё время работы и берёт первую доступную модель из цепочки предпочтений. Если ни одной нет, идёт AGY_DEFAULT_MODEL, потом модель agy по умолчанию. Имена проверяются заранее, потому что неизвестный --model agy молча игнорирует, и запрос ушёл бы не туда.
Квоты в print-режиме agy не показывает: на 429 он повторяет попытку до своего таймаута и выходит с пустым выводом. Сервер читает лог запуска, в этом случае сразу убивает процесс и разбирает время сброса из сообщения. Нужны Node.js 18+ и установленный, авторизованный agy. Без него серверу нечего вызывать, а слишком короткий таймаут клиента даст timed out waiting for response на холодном старте analyze_files.
Какие задачи решает
- разобрать большой лог, не забивая контекст Claude
- найти виновника регрессии по
git logиgit blame - сверить реализацию с внешней документацией API
- получить критику плана до правок в коде
- продолжить прошлую сессию с агентом без повторной отправки контекста
Примеры запросов агенту
- Разбери этот лог через
analyze_filesи верни только список ошибок. - Прогони план миграции через
adversarial_reviewдо того, как я начну править код. - Продолжи прошлую сессию через
follow_upс тем жеsession_id.
Как установить agy-bridge
Командой платформы
claude mcp add --env AGY_PATH=<AGY_PATH> --env AGY_TIMEOUT=<AGY_TIMEOUT> --env AGY_MAX_OUTPUT_CHARS=<AGY_MAX_OUTPUT_CHARS> --env AGY_DEFAULT_MODEL=<AGY_DEFAULT_MODEL> --env AGY_ON_FAILURE=<AGY_ON_FAILURE> --transport stdio agy-bridge -- npx -y agy-bridgeВместо <…> подставьте свои значения
Командой платформы
codex mcp add agy-bridge --env AGY_PATH=<AGY_PATH> --env AGY_TIMEOUT=<AGY_TIMEOUT> --env AGY_MAX_OUTPUT_CHARS=<AGY_MAX_OUTPUT_CHARS> --env AGY_DEFAULT_MODEL=<AGY_DEFAULT_MODEL> --env AGY_ON_FAILURE=<AGY_ON_FAILURE> -- npx -y agy-bridgeВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"agy-bridge": {
"command": "npx",
"args": [
"-y",
"agy-bridge"
],
"env": {
"AGY_PATH": "<AGY_PATH>",
"AGY_TIMEOUT": "<AGY_TIMEOUT>",
"AGY_MAX_OUTPUT_CHARS": "<AGY_MAX_OUTPUT_CHARS>",
"AGY_DEFAULT_MODEL": "<AGY_DEFAULT_MODEL>",
"AGY_ON_FAILURE": "<AGY_ON_FAILURE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"agy-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"agy-bridge"
],
"env": {
"AGY_PATH": "<AGY_PATH>",
"AGY_TIMEOUT": "<AGY_TIMEOUT>",
"AGY_MAX_OUTPUT_CHARS": "<AGY_MAX_OUTPUT_CHARS>",
"AGY_DEFAULT_MODEL": "<AGY_DEFAULT_MODEL>",
"AGY_ON_FAILURE": "<AGY_ON_FAILURE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e AGY_PATH=<AGY_PATH> -e AGY_TIMEOUT=<AGY_TIMEOUT> -e AGY_MAX_OUTPUT_CHARS=<AGY_MAX_OUTPUT_CHARS> -e AGY_DEFAULT_MODEL=<AGY_DEFAULT_MODEL> -e AGY_ON_FAILURE=<AGY_ON_FAILURE> agy-bridge npx -y agy-bridgeВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о agy-bridge
Как установить agy-bridge в Claude Code?
Одной командой: claude mcp add agy-bridge -- npx -y agy-bridge. Она регистрирует MCP-сервер, после этого Claude Code видит его инструменты.
Что делает agy-bridge?
Выносит тяжёлые задачи из Claude Code в Antigravity CLI и возвращает в контекст только ответ. Заодно выбирает модель под конкретный инструмент.
Что нужно для работы?
Node.js 18+ и установленный agy с пройденной авторизацией. Путь к бинарю задаётся в AGY_PATH, модель по умолчанию — в AGY_DEFAULT_MODEL.
