⚡ Antigravity MCP Bridge

El puente de código abierto que conecta Google Cloud AI con tu máquina local mediante el Model Context Protocol

Prueba de concepto verificada: Un solo prompt de Gemini Spark — "Crea una calculadora con pruebas unitarias" — produjo, ejecutó e hizo commit de código Python funcional en GitHub en menos de 3 segundos. Cero copiar y pegar humano.

Arquitectura • API de herramientas • Inicio rápido • Ecosistema de Google • Documentación para desarrolladores • Recursos y enlaces • Beneficios

🧩 ¿Qué es este proyecto?

Antigravity MCP Bridge rompe la barrera entre Cloud AI y tu máquina local. Ejecuta un servidor local del Model Context Protocol (MCP) que expone todo tu sistema operativo — terminal, archivos, compiladores y Git — a cualquier orquestador de IA compatible con MCP a través de un túnel HTTPS seguro.

Conéctalo a Google Gemini Spark y obtendrás un ingeniero de software de IA totalmente autónomo que puede planificar, codificar, probar, corregir y publicar software directamente en tu disco.

Related MCP server: Nexus-MCP

🏗️ Arquitectura del sistema

┌────────────────────────────────────────────────────────────────────┐
│                🌐  GOOGLE CLOUD ECOSYSTEM                          │
│                                                                    │
│  ┌─────────────────┐  ┌──────────────────┐  ┌─────────────────┐  │
│  │  Gemini Spark   │  │  Google Workspace │  │  Vertex AI /    │  │
│  │  (Orchestrator) │  │  Docs/Drive/Gmail │  │  Cloud Run      │  │
│  └────────┬────────┘  └──────────────────┘  └─────────────────┘  │
└───────────┼────────────────────────────────────────────────────────┘
            │  JSON-RPC 2.0 (Streamable HTTP / SSE)
            │  HTTPS via ngrok / Cloudflare Tunnel
┌───────────▼────────────────────────────────────────────────────────┐
│          ⚡  ANTIGRAVITY MCP BRIDGE  (Your Machine)                │
│                                                                    │
│   /mcp  (Streamable HTTP)    /sse  (Server-Sent Events)           │
│   CORS · Authentication · 7 Registered MCP Tools                  │
│                                                                    │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────────┐ │
│  │  File System │  │   Terminal   │  │  Antigravity Subagents   │ │
│  │  Read/Write  │  │  Shell/CMD   │  │  (Autonomous Tasks)      │ │
│  └──────────────┘  └──────────────┘  └──────────────────────────┘ │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────────┐ │
│  │   Python     │  │  Node.js/npm │  │   Git / Docker / CI      │ │
│  └──────────────┘  └──────────────┘  └──────────────────────────┘ │
└────────────────────────────────────────────────────────────────────┘

Protocolo de transporte

🧰 Referencia completa de herramientas

🔧 Herramienta 1: run_system_command

Ejecuta cualquier comando de shell, PowerShell o Bash. Captura el código de salida, stdout y stderr.

// Example: Run Python unit tests
{
  "name": "run_system_command",
  "arguments": {
    "command": "python -m pytest tests/ -v",
    "working_dir": "C:/Users/dev/myproject"
  }
}

Úsalo para: Ejecutar Python/Node/Java/Rust, pip install, npm install, operaciones de Git, ejecutores de pruebas, Docker, pipelines de CI.

📝 Herramienta 2: write_file

Crea o sobrescribe cualquier archivo en el disco con contenido generado por IA. Crea directorios automáticamente.

// Example: Write a FastAPI route
{
  "name": "write_file",
  "arguments": {
    "file_path": "src/api/routes.py",
    "content": "from fastapi import APIRouter\nrouter = APIRouter()\n\n@router.get('/health')\ndef health(): return {'status': 'ok'}"
  }
}

Úsalo para: Escribir código fuente, configuraciones, Dockerfiles, YAML de GitHub Actions, documentos Markdown, archivos .env.

📖 Herramienta 3: read_file

Lee y devuelve el contenido completo de cualquier archivo local.

{
  "name": "read_file",
  "arguments": { "file_path": "src/main.py" }
}

Úsalo para: Inspeccionar código antes de refactorizar, leer logs, auditar configuraciones, leer conjuntos de datos.

📂 Herramienta 4: list_directory

Enumera archivos y directorios con tipo y tamaño.

{
  "name": "list_directory",
  "arguments": { "directory_path": "C:/Users/dev/myproject" }
}

Úsalo para: Descubrir la estructura del proyecto, verificar que los archivos se crearon, auditar repositorios.

🤖 Herramienta 5: run_agent_task

Lanza un subagente de IA de Antigravity autónomo y de larga duración para objetivos complejos de varios pasos. Devuelve al instante un task_id.

{
  "name": "run_agent_task",
  "arguments": {
    "prompt": "Refactor all Python files to use async/await. Run tests after each file.",
    "workspace_dir": "C:/Users/dev/myproject"
  }
}

Úsalo para: Refactorización a gran escala, desarrollo completo de funcionalidades, TDD autónomo, auditorías de seguridad.

📊 Herramienta 6: get_agent_status

Consulta el progreso en vivo, la salida y los errores de una tarea de subagente en segundo plano.

{
  "name": "get_agent_status",
  "arguments": { "task_id": "a1b2c3d4" }
}
// Returns: { "status": "completed", "output": "...", "error": null }

🛑 Herramienta 7: terminate_task

Cancela de forma segura cualquier tarea de subagente en segundo plano que esté en ejecución.

🔗 Integración con el ecosistema de Google

Gemini Spark

Conecta tu puente a Gemini mediante Custom Connected Apps.

• 📖 Inicio de Gemini

• 📖 Documentación de la API de Gemini

• 📖 Gemini para Google Workspace

Google Cloud

Despliega el puente en Cloud o intégralo con Cloud AI.

• 📖 Google Cloud Console

• 📖 Documentación de Cloud Run

• 📖 Documentación de Cloud Build

Vertex AI

Orquestación de IA de nivel empresarial con ejecución local.

• 📖 Documentación de Vertex AI

• 📖 Vertex AI Workbench

• 📖 Generative AI on Vertex AI

Google Workspace

Usa Docs, Drive y Gmail como fuentes de contexto para IA.

• 📖 APIs de Google Workspace

• 📖 API de Google Drive

• 📖 API de Google Docs

📚 Documentación oficial y recursos externos

🔵 Model Context Protocol (MCP)

🟣 Google Antigravity (AGY)

🔵 Google Gemini y APIs de IA

☁️ Plataforma Google Cloud

🐍 Python y Bibliotecas Principales

🌐 Marco Web y ASGI

🔒 Túneles y Exposición Segura

📡 Especificaciones JSON-RPC y SSE

🔧 Herramientas de Desarrollo

🚀 Inicio rápido

Requisitos previos

Paso 1 — Clonar e instalar

git clone https://github.com/nandhakumar-murugan/antigravity-mcp-bridge.git
cd antigravity-mcp-bridge
pip install -r requirements.txt

Paso 2 — Añade tu token de ngrok

Obtén tu token en dashboard.ngrok.com/get-started/your-authtoken

Edita run_with_tunnel.py:

AUTHTOKEN = "your_ngrok_authtoken_here"

Paso 3 — Iniciar

# Windows (Double-click or run):
start_server.bat

# macOS / Linux:
python run_with_tunnel.py

Salida:

[INFO] NGROK MCP TUNNEL IS LIVE!
[LINK] PASTE THIS IN GEMINI SPARK: https://xxxx.ngrok-free.dev/mcp

Paso 4 — Conectar con Gemini Spark

1. Abre gemini.google.com

2. Ve a Configuración → Aplicaciones personalizadas conectadas

3. Pega: https://xxxx.ngrok-free.dev/mcp

4. Acepta los permisos → Haz clic en Guardar

5. Escribe @Antigravity System Bridge en cualquier chat para activarlo.

💻 Guía de integración para desarrolladores

Python (SDK oficial de MCP)

import asyncio
from mcp.client.session import ClientSession
from mcp.client.streamable_http import streamable_http_client

async def main():
    url = "https://xxxx.ngrok-free.dev/mcp"
    async with streamable_http_client(url) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])

            # Run a command
            result = await session.call_tool("run_system_command", {
                "command": "python --version"
            })
            print(result.content[0].text)

asyncio.run(main())

cURL (Cualquier lenguaje)

curl -X POST https://xxxx.ngrok-free.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0"}}}'

Configuración de Claude Desktop

{
  "mcpServers": {
    "antigravity-bridge": {
      "command": "python",
      "args": ["run_with_tunnel.py"],
      "env": { "NGROK_AUTHTOKEN": "your_token" }
    }
  }
}

👥 ¿Quiénes se benefician?

🎓 Estudiantes

• Ve código real escrito y ejecutado en tu disco, no en entornos de prueba falsos

• La IA se encarga de pip install, entornos virtuales y configuración de PATH por ti

• Aprende a depurar viendo a la IA corregir errores reales de terminal en vivo

💻 Ingenieros

• TDD autónomo completo: la IA escribe código → ejecuta pruebas → corrige fallos → repite

• Delega funciones completas: "Crea una API REST con autenticación" → listo en minutos

• No más copiar y pegar entre el chat y el editor

🔬 Investigadores

• Ejecuta pipelines locales de Python sin subir datos sensibles a la nube

• Automatiza scripts de experimentos, benchmarks y análisis de datos de forma conversacional

• Usa cómputo local con GPU mediante comandos de terminal

📁 Estructura del proyecto

antigravity-mcp-bridge/
├── server.py               # Core MCP server with all 7 tool definitions
├── run_with_tunnel.py      # One-click launcher (server + ngrok tunnel)
├── start_server.bat        # Windows double-click starter
├── test_client.py          # MCP connection verification script
├── calculator.py           # Example: AI-generated code via Gemini Spark
├── test_calculator.py      # Example: AI-generated tests (all 6 passed)
├── requirements.txt        # Python dependencies
├── .gitignore
├── LICENSE                 # MIT
└── README.md

📦 requirements.txt

mcp>=2.0.0
uvicorn
fastapi
pyngrok
python-dotenv

🛡️ Seguridad

• Todo el tráfico está cifrado con TLS mediante HTTPS de ngrok

• El Authtoken de ngrok previene el acceso no autorizado

• Tiempo de espera de 180 segundos en todas las ejecuciones de terminal

• terminate_task detiene inmediatamente cualquier subagente en ejecución

• Todas las operaciones son totalmente visibles en tu terminal local

📄 Licencia

Licencia MIT — consulta LICENSE para más detalles.

Construido con el ecosistema de Google. Impulsado por estándares abiertos.

⭐ Marca este repositorio con una estrella si te fue útil. | 🍴 Haz un fork para personalizarlo para tu equipo

🐛 Reportar problemas · 💬 Discusiones · 🤝 Contribuir