Antigravity MCP Bridge (Antigravity 2.0 ↔ Gemini Spark)

Controla programáticamente los agentes de Google Antigravity 2.0 en Windows mediante Gemini Spark y clientes MCP remotos/locales a través de transporte HTTP Streamable y stdio.

Resumen de la arquitectura

Gemini Spark (or Remote MCP Client)
      │
      │ HTTPS Request (Authorization: Bearer <MCP_AUTH_TOKEN>)
      ▼
Tailscale Funnel (Public HTTPS: https://<node>.<tailnet>.ts.net/mcp)
      │
      │ Encrypted Local Tunnel
      ▼
Streamable HTTP MCP Server (src/http_server.py on 127.0.0.1:8000)
      │
      ├── AuthMiddleware (Validates MCP_AUTH_TOKEN -> 401 Unauthorized if invalid)
      ├── /health & /healthz Diagnostic Endpoints
      │
      ▼
FastMCP Core Server (src/server.py - Streamable HTTP & stdio)
      │
      ├── launch_antigravity_agent
      ├── get_session_status
      ├── list_workspace_artifacts
      └── run_antigravity_cli_command
      │
      ▼
Antigravity Bridge Adapter -> agentapi.bat -> Antigravity 2.0 Runtime -> Local Workspace

Related MCP server: tailscale-mcp

Inicio rápido (operaciones con un clic en Windows)

• START.bat: Inicializa el entorno, crea .env con un token de autenticación seguro, inicia el servidor HTTP en segundo plano en 127.0.0.1:8000, habilita Tailscale Funnel y muestra el banner de conexión.

• STATUS.bat: Inspecciona el estado del servidor en vivo, el estado del PID, el estado del token de autenticación, el inicio de sesión de Tailscale y el estado de Funnel, y la disponibilidad del runtime de Antigravity.

• STOP.bat: Termina correctamente el proceso del servidor HTTP MCP y deshabilita el mapeo de Tailscale Funnel.

Características principales

1. Soporte de transporte dual:

   • Transporte Stdio para clientes MCP locales (python src/server.py).

   • Transporte HTTP Streamable para Gemini Spark y clientes remotos (START.bat / python -m src.http_server).

2. Autenticación y protección de tokens:

   • AuthMiddleware que aplica la validación de tokens en /mcp.

   • Admite Authorization: Bearer <token>, x-api-key: <token> o ?token=<token>.

   • Genera automáticamente un token hexadecimal de 32 caracteres si falta en .env.

3. Integración con Tailscale Funnel:

   • Punto final HTTPS público y seguro sin comprar un dominio.

   • Detección sólida, informes de estado y orientación para la resolución cuando Tailscale está ausente o deshabilitado.

4. Motor local de Antigravity 2.0:

   • Integración de configuración cero con el servidor de lenguaje local de Antigravity mediante agentapi.bat.

5. Seguridad y aislamiento del espacio de trabajo:

   • Validación de límites del espacio de trabajo que previene ataques de traversal de rutas.

   • Redacción automática de claves secretas y tokens de los flujos de salida.

   • Bloqueo de ejecución concurrente del espacio de trabajo que previene conflictos entre múltiples agentes.

Herramientas MCP expuestas

• launch_antigravity_agent: Lanza una tarea de agente de Antigravity dirigida a un espacio de trabajo local.

• get_session_status: Inspecciona el estado de la sesión, las marcas de tiempo y los metadatos en vivo.

• list_workspace_artifacts: Indexa archivos, tamaños, marcas de tiempo y hashes SHA256 en el espacio de trabajo.

• run_antigravity_cli_command: Ejecuta subcomandos agentapi compatibles (get-conversation-metadata, send-message, new-conversation).

Verificación y suite de pruebas

Ejecute las pruebas automatizadas completas de unidad e integración:

.venv\Scripts\python.exe -m pytest tests/

Ejecute la prueba de integración HTTP MCP de extremo a extremo real:

.venv\Scripts\python.exe remote_smoke_test.py

Ejecute la prueba de humo local de stdio:

.venv\Scripts\python.exe smoke_test.py

Documentación

La documentación detallada está disponible en docs/:

• docs/remote-access.md: Guía completa para el acceso remoto, Tailscale Funnel y la conexión con Gemini Spark.

• docs/mcp-setup.md: Fragmentos de configuración de cliente para Gemini Spark y Antigravity IDE.

• docs/security.md: Modelo de seguridad, validación de rutas y reglas de redacción de secretos.

• docs/troubleshooting.md: Matriz de resolución de problemas y pasos de recuperación de diagnóstico.

• FINAL-REPORT.md: Informe completo del estado de integración y matriz de verificación empírica.