agent-bridge-mcp

Сервер MCP и HTTP-шлюз, который распределяет задачи кодирования между сеансами Claude Code, Codex и Antigravity (agy) CLI, отслеживает эти сеансы и при необходимости запускает цикл реализация → рецензирование → проверка в реальном репозитории.

Статус: экспериментальный. Изначально это был личный оркестрационный инструмент, и он публикуется в надежде, что части маршрутизации сеансов и шлюза проверки окажутся полезными другим. Интерфейсы будут меняться.

Что он делает

• Маршрутизация сеансов — запускает и возобновляет сеансы Claude Code / Codex для каждого проекта и темы, так что последующие запросы попадают в тот же контекст.

• Отслеживание задач — каждое отправление становится задачей с состоянием, выводом и кодом выхода.

• Шлюз проверки — выполняет указанные вами тестовые команды в репозитории и сообщает, подтверждено ли изменение проходящими тестами, прежде чем вы его примете.

• Цикл рецензирования — поочередно отправляет агента-исполнителя и агента-рецензента до заданного лимита правок, с проверкой через шлюз проверки.

• Шлюз — те же возможности через HTTP + WebSocket, так что удаленный клиент (например, телефон) может отправлять задачи и получать потоковый вывод.

Установка

npm install -g @yukinuma/agent-bridge-mcp

Требуется Node.js 20+, а также установленные и аутентифицированные CLI-агенты, которые вы собираетесь использовать (claude, codex и/или agy).

Замечание об агенте antigravity

agy запускает внутренний языковой сервер и ожидает реальный терминал. При запуске из обычного канала он завершается до того, как ответит, что со стороны вызывающего кода неотличимо от зависания. Поэтому на Windows этот адаптер запускает его под winpty (входит в состав Git for Windows) и держит stdin открытым на время вызова.

Два важных следствия:

• winpty прерывается на собственном утверждении при завершении, поэтому его код выхода не отражает то, что сделал agy. При работе через pty адаптер оценивает успех по тому, пришел ли ответ, а не по коду выхода, и отфильтровывает текст утверждения из захваченного вывода.

• При тайм-ауте дерево процессов убивается по PID. Убийство по имени образа могло бы затронуть любые интерактивные сеансы agy, открытые в другом месте, поэтому это намеренно не делается.

Установите WINPTY_PATH или AGY_PATH, если какой-либо из бинарников находится в нестандартном месте. На платформах, отличных от Windows, agy запускается напрямую, что не тестировалось.

Использование в качестве MCP-сервера

{
  "mcpServers": {
    "agent-bridge": {
      "command": "agent-bridge-mcp",
      "env": {
        "AGENT_BRIDGE_WORKSPACE": "/path/to/your/projects"
      }
    }
  }
}

Доступные инструменты: agent_send, agent_status, agent_sessions, agent_cancel.

Использование в качестве шлюза

export ABC_AUTH_TOKEN="$(openssl rand -hex 24)"
export AGENT_BRIDGE_WORKSPACE="/path/to/your/projects"
agent-bridge-gateway

Шлюз отказывается запускаться без ABC_AUTH_TOKEN. Токена по умолчанию нет.

Конечные точки

/api/dispatch, /api/git/commit-push и /api/review-loop требуют явной цели — либо cwd, либо project, который разрешается внутри рабочей области. Они возвращают 400, а не используют директорию по умолчанию, и значения project, выходящие за пределы рабочей области, отклоняются.

Безопасность

Этот сервис запускает агентов кодирования с отключенными подсказками безопасности. Именно это делает возможной автоматическую отправку — агент, который останавливается для запроса одобрения, просто зависает, когда за клавиатурой никого нет, но это означает, что любой, кто может получить доступ к API, может выполнить произвольный код от имени пользователя, запустившего шлюз.

В частности, адаптеры CLI передают:

Оба по умолчанию обходят проверки. Отказы от участия — это опции на уровне адаптера; они пока не проведены через инструменты MCP или REST API, поэтому через HTTP обход в настоящее время безусловен.

Относитесь к этому как к привилегированному локальному демону:

• Он привязывается к 127.0.0.1 по умолчанию. Установка AGENT_BRIDGE_HOST на что-либо другое открывает отправку задач, выполнение кода без песочницы и git push в вашу сеть.

• Токен аутентификации — это один общий секрет, передаваемый в заголовке Bearer или параметре запроса token. Параметры запроса попадают в журналы — предпочитайте заголовок, где это возможно. Компрометация этого единственного токена равносильна передаче оболочки.

• Между проектами нет изоляции, кроме проверки пути рабочей области.

• /api/git/commit-push отправляет изменения в тот удаленный репозиторий, который настроен в целевом репозитории. Он не спрашивает повторно перед отправкой.

Не открывайте доступ к этому сервису из ненадежной сети и не запускайте его от имени пользователя с большими правами, чем необходимо для работы.

Разработка

npm install
npm run typecheck
npm run build

Лицензия

MIT