antigravity-mcp-server

Permite que dos agentes de IA construyan tu aplicación al mismo tiempo, sin pisarse.

Tu agente se encarga del backend. Antigravity se encarga de la interfaz. Ninguno rompe los archivos del otro.

El problema

Ejecutar dos agentes de IA de codificación en un mismo proyecto suena genial, hasta que ambos editan el mismo archivo y destruyen silenciosamente el trabajo del otro.

No pueden verse entre sí. Ese es el problema.

Related MCP server: asynkor

La solución

Un pequeño servidor al que ambos agentes se conectan. Les proporciona una memoria compartida: quién está haciendo qué, qué archivos están ocupados y qué necesitan comunicarse.

   Your AI agent                                    Antigravity
   Claude Code · Cursor · Windsurf                  (agy CLI)
   VS Code · Gemini CLI · OpenCode
          │                                              │
          │  MCP                                     MCP │
          └──────────────┐                ┌──────────────┘
                         ▼                ▼
              ┌─────────────────────────────────┐
              │        antigravity-mcp-server          │
              │                                 │
              │   board.json                    │
              │    ├─ tasks .... who does what  │
              │    ├─ locks .... files taken    │
              │    ├─ notes .... messages       │
              │    └─ presence . who is online  │
              └─────────────────────────────────┘
                              │
                              └──► starts `agy` in the background

Instalación

npx antigravity-mcp-server init

Eso es todo. Este único comando:

• encuentra todas las herramientas de IA en tu computadora

• añade el servidor a cada una

• activa el permiso que Antigravity necesita

Ahora reinicia tus herramientas de IA para que lo reconozcan.

¿Prefieres instalarlo de forma permanente en lugar de descargarlo en cada ejecución?

npm install -g antigravity-mcp-server
antigravity-mcp-server init

Otros comandos:

antigravity-mcp-server doctor           # is everything working?
antigravity-mcp-server doctor --probe   # same, plus a real round trip through agy
antigravity-mcp-server init --dry-run   # show changes, write nothing
antigravity-mcp-server init --all       # also write configs for tools you haven't installed
antigravity-mcp-server init --only claude-code,cursor

Necesitas: Node 18.17 o superior, y la CLI de Antigravity (agy). Sin agy aún obtienes el tablero compartido, pero no puedes delegar trabajo a Antigravity.

Cómo se usa

No necesitas aprender comandos. Solo habla con tu agente:

"Construye la página de pago con Antigravity mientras tú haces la API de pagos."

Tu agente se encarga del resto. Esto es lo que realmente sucede:

  time ──────────────────────────────────────────────────────►

  your agent   ███ writes brief ███│████ payments API ████│ checks result
                                   │                      │
  Antigravity                      │███ checkout page ███ │
                                   │                      │
                                   └── both work at once ─┘

Tu agente escribe un resumen completo, bloquea sus propios archivos, inicia Antigravity en segundo plano y sigue trabajando. Nadie espera.

Por qué es importante el tablero compartido

1. Bloqueo de archivos

Antes de que un agente edite un archivo, lo reclama. Bloquear una carpeta bloquea todo su contenido.

  my-app/
  ├── api/           [locked] your agent    ← Antigravity is told "taken"
  ├── db.ts          [locked] your agent
  ├── components/    [locked] Antigravity   ← your agent stays away
  └── styles/        [locked] Antigravity

Si un agente intenta tomar un archivo bloqueado, recibe un conflicto claro. Sin sobrescritura silenciosa.

2. Notas

La interfaz se está construyendo contra una API que aún no existe. Así que los dos agentes se pasan el plan de un lado a otro:

"POST /api/orders está listo. Devuelve { id, status }. Conecta el formulario a él."

Esto es lo que mantiene ambas mitades encajando.

3. Presencia

Cada agente puede verificar lo que el otro está haciendo antes de comenzar, para elegir trabajo que no entre en conflicto.

Las herramientas

Tu agente las elige por sí mismo. Nunca las escribes.

Dos que vale la pena conocer:

coop_status — una sola llamada responde todo: quién está en línea, qué se está ejecutando, qué está bloqueado, qué no se ha leído.

ag_followup — continúa la misma conversación de Antigravity. Así que "ahora hazlo funcionar en móvil" mantiene todo el contexto en lugar de empezar desde cero.

Cómo funciona internamente

Archivos en disco

~/.antigravity-mcp/
├── board.json                    shared state, written under a lock
└── runs/
    ├── <task_id>.json            agy's raw result
    ├── <task_id>.prompt.txt      the brief that was sent
    └── <task_id>.err             stderr, if the run failed

board.json contiene tasks, locks, notes, events y presence. Cada escritura toma un bloqueo exclusivo (un directorio creado atómicamente, la única primitiva que se comporta igual en Windows y POSIX), luego se guarda mediante escribir-temp-y-renombrar, para que un fallo no pueda dejar un tablero a medio escribir. Los bloqueos obsoletos de más de 20 segundos se rompen automáticamente.

No hay SQLite. Una compilación nativa rompería npx en máquinas sin compilador, y node:sqlite sigue siendo experimental y requiere Node 22+. El tablero recibe un puñado de escrituras pequeñas por minuto, por lo que un archivo JSON es la herramienta del tamaño adecuado.

Delegación

ag_delegate ejecuta externamente:

agy --print <brief> --output-format json --print-timeout <n>s \
    --add-dir <cwd> --mode accept-edits --dangerously-skip-permissions

El proceso hijo se inicia separado, con stdout redirigido directamente a runs/<task_id>.json. Esto significa que un trabajo largo sobrevive al reinicio del servidor MCP: el estado se recupera leyendo el archivo de ejecución y verificando el PID, no manteniendo un control del proceso hijo.

ag_followup reutiliza el conversation_id de la salida JSON de agy mediante --conversation, por lo que el contexto se mantiene entre llamadas.

Bloqueos de rutas

Las rutas se normalizan con path.resolve y se convierten a minúsculas en Windows, para que C:\Proj y c:\proj no puedan burlar el mismo bloqueo. La superposición se verifica en ambas direcciones: reclamar api/routes.ts entra en conflicto con un api/ bloqueado, y reclamar api/ entra en conflicto con un api/routes.ts bloqueado.

Identidad del agente

Cada lado ejecuta el mismo binario con un --agent <id> diferente. Ese id es a lo que se atribuye cada entrada del tablero. Dos clientes que comparten un mismo id hacen que sus bloqueos sean invisibles entre sí, lo que anula todo el propósito.

Dónde se escriben las configuraciones

init solo toca las herramientas que encuentra, y hace una copia de seguridad de cualquier archivo que edita en <archivo>.bak-antigravity-mcp.

Bueno saber

Los trabajos largos son seguros. Antigravity se ejecuta de forma separada. Si tu editor o el servidor se reinician, el trabajo continúa.

Antigravity edita sin preguntar. ag_delegate pasa --dangerously-skip-permissions para que pueda trabajar sin supervisión. Pasa auto_approve: false para que se detenga en los avisos.

Una trampa que init maneja por ti. En modo sin interfaz gráfica, agy deniega automáticamente cada llamada MCP a menos que esté en la lista blanca de ~/.gemini/antigravity-cli/settings.json. Si esa regla falta, la delegación aún se ejecuta pero la coordinación no hace nada en silencio, el peor tipo de fallo, porque parece que funciona. init añade mcp(coop/*); doctor lo verifica.

Antigravity trabaja en su propio proyecto temporal a menos que el directorio de destino esté en su espacio de trabajo. Cada transferencia pasa --add-dir <cwd> y declara la raíz del proyecto en el resumen.

Configuración

Configuración manual

Añade esto a la configuración MCP de tu herramienta:

{
  "mcpServers": {
    "antigravity": {
      "command": "npx",
      "args": ["-y", "antigravity-mcp-server", "--agent", "claude-code"]
    }
  }
}

En el lado de Antigravity, nombra el servidor coop, usa --agent antigravity, y añade esto a ~/.gemini/antigravity-cli/settings.json:

{ "permissions": { "allow": ["mcp(coop/*)"] } }

La clave del servidor debe coincidir con la regla de lista blanca: coop aquí, mcp(coop/*) allá.

Trabajando en el código

git clone https://github.com/adeelali4/antigravity-mcp
cd antigravity-mcp
npm install

npm test                    # 16 checks, two live stdio clients, no agy credits used
node test/delegation.js     # real end-to-end run (uses agy credits)
node src/cli.js init --local --dry-run

npm test inicia dos clientes MCP reales como procesos separados contra un mismo tablero, por lo que el bloqueo entre procesos y la mensajería se cubren de verdad, no simulados.

MIT · construido por adeelali4