Antigravity Codex MCP

{"type": "text"}# Antigravity Codex MCP

Un puente controlado del Model Context Protocol que permite a OpenAI Codex delegar trabajo a la CLI de Google Antigravity bajo demanda.

El puente permanece inactivo hasta que un usuario pide explícitamente a Codex que use AGY. Entonces autoriza solo el proyecto actual exacto, mantiene una conversación limitada al proyecto, sincroniza el diálogo visible para el usuario y confina los cambios de implementación generados a una copia aislada.

Este es un proyecto comunitario independiente. No está afiliado ni respaldado por Google u OpenAI.

中文说明

Aspectos destacados

• Adopción explícita: Codex no puede habilitar ni llamar a AGY a menos que el usuario lo pida.

• Alcance exacto del proyecto: se rechazan raíces amplias y directorios del sistema.

• Delegación de solo lectura por defecto: no se concede ningún permiso de escritura, comando, URL o MCP de AGY.

• Conversaciones de proyecto: los IDs de conversación activos y el historial de delegación sobreviven a nuevas tareas de Codex.

• Sincronización de transcripciones visibles: los mensajes introducidos a través de la CLI de AGY están disponibles para Codex en la siguiente sincronización.

• Filtro de razonamiento privado: los campos de pensamiento/razonamiento, los mensajes del sistema y los puntos de control se excluyen antes de la persistencia o la devolución al MCP.

• Implementación aislada: los reemplazos validados de archivos completos se aplican solo a una copia desechable del proyecto.

• Ejecuciones auditables: las respuestas, los manifiestos de archivos modificados, la salida de verificación y los eventos de herramientas saneados se conservan localmente.

Related MCP server: codex-agy-bridge

Requisitos

• Node.js 20 o superior

• Antigravity CLI

• OpenAI Codex with MCP support

Autentica la CLI de Antigravity y verifica que agy esté disponible:

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

Si agy no está en PATH, establece AGY_BIN a su ruta ejecutable en la configuración del MCP.

Instalación

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

Añade el servidor a tu config.toml de Codex. Reemplaza las rutas de ejemplo con la ruta absoluta del clon en tu máquina:

[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'

En macOS o Linux, usa las rutas POSIX absolutas correspondientes y normalmente omite AGY_BIN cuando agy esté en PATH.

Instala el Codex Skill incluido para que Codex siga el flujo de adopción explícita:

$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

Reinicia Codex después de cambiar la configuración del MCP o de instalar el Skill.

Uso

1. Abre cualquier directorio de proyecto en Codex.

2. Trabaja con normalidad; el puente AGY permanece inactivo.

3. Pide explícitamente: Load AGY and review this project.

4. Codex habilita el acceso de lectura para ese proyecto exacto e inicia o reutiliza su conversación AGY.

5. Codex delega análisis, revisión, continuación o implementación aislada según corresponda.

6. Pide Disable AGY for this project para revocar el permiso exacto del proyecto conservando el historial de auditoría local.

Para inspeccionar o participar directamente en la misma conversación:

agy --conversation=<conversation_id>

Después de enviar mensajes a través de la CLI de AGY, pide a Codex que sync the AGY conversation. antigravity_continue también sincroniza antes y después de cada seguimiento. La sincronización es bajo demanda, no un canal de empuje en vivo, así que evita envíos simultáneos desde Codex y la CLI de AGY.

Herramientas MCP

Las llamadas al modelo ocurren solo a través de las herramientas start, ask, continue, review y execute. La salud, el estado, el historial, la inspección de ejecuciones y la sincronización de transcripciones no consumen un turno de modelo de AGY.

Estado local del proyecto

Cada proyecto habilitado recibe un directorio de estado local ignorado:

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

• project.json registra el estado de adopción y la conversación activa.

• sessions.jsonl registra las llamadas delegadas y el uso de tokens.

• transcripts contiene solo registros visibles de usuario/asistente y trazas de herramientas saneadas.

• runs contiene espacios de trabajo de implementación aislada y resultados de auditoría.

Este directorio se excluye de la copia fuente y Git lo ignora. No lo confirmes manualmente porque puede contener datos privados del proyecto o de la conversación.

Modelo de seguridad

La habilitación del proyecto añade atómicamente solo la raíz exacta a las reglas de permitidos trustedWorkspaces y read_file(...) de Antigravity. La deshabilitación elimina solo esas entradas exactas.

La implementación aislada rechaza:

• rutas absolutas y recorrido de directorios padre;

• eliminación de archivos;

• archivos secretos, dependencias, salida de compilación, metadatos y enlaces simbólicos;

• más de 50 archivos modificados;

• más de 2,000,000 de caracteres de reemplazo.

El pipeline de transcripciones elimina recursivamente los campos de razonamiento privados y excluye los registros de sistema/puntos de control antes de escribir el espejo del proyecto. Consulta SECURITY.md para obtener orientación sobre informes y limitaciones.

Desarrollo

npm ci
npm test
npm run smoke:mcp

Las comprobaciones en vivo requieren una CLI de AGY autenticada y consumen cuota de modelo:

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 es autónomo. smoke:mcp también comprueba el binario AGY local, mientras que el resto de pruebas de humo pueden cambiar la autorización del proyecto o consumir cuota.

Licencia

MIT