Antigravity Codex MCP

Управляемый мост Model Context Protocol, который позволяет OpenAI Codex делегировать работу Google Antigravity CLI по запросу.

Мост остаётся в режиме ожидания, пока пользователь явно не попросит Codex использовать AGY. Затем он авторизует только точный текущий проект, сохраняет беседу в рамках проекта, синхронизирует видимый пользователю диалог и не позволяет генерируемым изменениям реализации выйти за пределы изолированной копии.

Это независимый проект сообщества. Он не связан с Google или OpenAI и не одобрен ими.

中文说明

Возможности

• Явное согласие: Codex не может включить или вызвать AGY, если пользователь об этом не попросит.

• Точная область проекта: широкие корневые пути и системные каталоги отклоняются.

• Делегирование только на чтение по умолчанию: не предоставляется никаких разрешений AGY на запись, команды, URL или MCP.

• Проектные беседы: идентификаторы активных бесед и история делегирования сохраняются при новых задачах Codex.

• Синхронизация видимых транскриптов: сообщения, введённые через AGY CLI, становятся доступны Codex при следующей синхронизации.

• Фильтр приватных рассуждений: поля thinking/reasoning, системные сообщения и контрольные точки исключаются перед сохранением или возвратом через MCP.

• Изолированная реализация: проверенные замены целых файлов применяются только к одноразовой копии проекта.

• Аудируемые запуски: ответы, манифесты изменённых файлов, результаты проверки и очищенные события инструментов сохраняются локально.

Related MCP server: codex-agy-bridge

Требования

• Node.js 20 или новее

• Antigravity CLI

• OpenAI Codex с поддержкой MCP

Аутентифицируйте Antigravity CLI и убедитесь, что agy доступен:

agy --version
agy -p "Reply exactly: AGY_OK" --output-format json

Если agy отсутствует в PATH, укажите AGY_BIN как путь к исполняемому файлу в конфигурации MCP.

Установка

git clone https://github.com/ustc-fyk/antigravity-codex-mcp.git
cd antigravity-codex-mcp
npm ci
npm test

Добавьте сервер в ваш config.toml Codex. Замените примеры путей на абсолютный путь к клонированному репозиторию на вашей машине:

[mcp_servers.antigravity]
command = 'node'
args = ['C:\path\to\antigravity-codex-mcp\src\index.js']
cwd = 'C:\path\to\antigravity-codex-mcp'
enabled = true
required = false
startup_timeout_sec = 20
tool_timeout_sec = 900
default_tools_approval_mode = 'prompt'
enabled_tools = [
  'antigravity_health',
  'antigravity_project_status',
  'antigravity_enable_project',
  'antigravity_disable_project',
  'antigravity_start_session',
  'antigravity_get_active_session',
  'antigravity_list_sessions',
  'antigravity_sync_conversation',
  'antigravity_get_transcript',
  'antigravity_ask',
  'antigravity_continue',
  'antigravity_review',
  'antigravity_execute',
  'antigravity_list_runs',
  'antigravity_get_run',
]

# Optional when agy is not available on PATH:
[mcp_servers.antigravity.env]
AGY_BIN = 'C:\path\to\agy.exe'

В macOS или Linux используйте соответствующие абсолютные пути POSIX и обычно опускайте AGY_BIN, если agy находится в PATH.

Установите входящий в комплект Codex Skill, чтобы Codex следовал рабочему процессу с явным согласием:

$skillRoot = Join-Path $env:USERPROFILE ".codex\skills\agy-project-assistant"
New-Item -ItemType Directory -Force $skillRoot | Out-Null
Copy-Item ".\skills\agy-project-assistant\SKILL.md" $skillRoot

Перезапустите Codex после изменения конфигурации MCP или установки Skill.

Использование

1. Откройте любой каталог проекта в Codex.

2. Работайте как обычно; мост AGY остаётся в режиме ожидания.

3. Явно попросите: Load AGY and review this project.

4. Codex включает доступ на чтение для этого конкретного проекта и запускает или повторно использует беседу AGY.

5. Codex делегирует анализ, ревью, продолжение или изолированную реализацию по мере необходимости.

6. Попросите Disable AGY for this project, чтобы отозвать разрешение для конкретного проекта, сохранив локальную историю аудита.

Чтобы просмотреть ту же беседу или участвовать в ней напрямую:

agy --conversation=<conversation_id>

После отправки сообщений через AGY CLI попросите Codex sync the AGY conversation. antigravity_continue также выполняет синхронизацию до и после каждого последующего запроса. Синхронизация выполняется по запросу, а не через канал прямой трансляции, поэтому избегайте одновременной отправки из Codex и AGY CLI.

Инструменты MCP

Обращения к модели происходят только через инструменты start, ask, continue, review и execute. Проверка здоровья, статус, история, просмотр запусков и синхронизация транскриптов не расходуют ход модели AGY.

Локальное состояние проекта

Каждый включённый проект получает игнорируемый локальный каталог состояния:

.antigravity-mcp/
├── project.json
├── sessions.jsonl
├── transcripts/
│   └── <conversation-id>.jsonl
└── runs/
    └── <run-id>/
        ├── metadata.json
        ├── events.jsonl
        ├── response.md
        └── workspace/

• project.json хранит состояние явного согласия и активную беседу.

• sessions.jsonl хранит делегированные вызовы и использование токенов.

• transcripts содержит только видимые записи пользователя/ассистента и очищенные следы инструментов.

• runs содержит изолированные рабочие области реализации и результаты аудита.

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

Модель безопасности

Включение проекта атомарно добавляет только точный корневой путь в trustedWorkspaces Antigravity и правила разрешения read_file(...). Отключение удаляет только эти точные записи.

Изолированная реализация отклоняет:

• абсолютные пути и переход к родительским каталогам;

• удаление файлов;

• секретные файлы, зависимости, результаты сборки, метаданные и символические ссылки;

• более 50 изменённых файлов;

• более 2 000 000 символов замены.

Конвейер транскриптов рекурсивно удаляет поля приватных рассуждений и исключает системные записи и контрольные точки перед записью зеркала проекта. Руководство по сообщению об уязвимостях и ограничения см. в SECURITY.md.

Разработка

npm ci
npm test
npm run smoke:mcp

Живые проверки требуют аутентифицированного AGY CLI и расходуют квоту модели:

npm run smoke:live
npm run smoke:execute
npm run smoke:project -- "/absolute/path/to/disposable-project"
npm run smoke:continue -- "/absolute/path/to/enabled-project"
npm run smoke:transcript -- "/absolute/path/to/enabled-project"

npm test самодостаточен. smoke:mcp также проверяет локальный бинарный файл AGY, а остальные smoke-тесты могут изменять авторизацию проекта или расходовать квоту.

Лицензия

MIT