Antigravity MCP Bridge (Antigravity 2.0 ↔ Gemini Spark)

Steuern Sie Google Antigravity 2.0-Agenten unter Windows programmatisch über Gemini Spark und entfernte/lokale MCP-Clients per Streamable-HTTP- und stdio-Transport.

Architekturübersicht

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

Schnellstart (Windows-Ein-Klick-Operationen)

• START.bat: Initialisiert die Umgebung, erstellt .env mit einem sicheren Authentifizierungstoken, startet den HTTP-Server im Hintergrund auf 127.0.0.1:8000, aktiviert Tailscale Funnel und zeigt ein Verbindungsbanner an.

• STATUS.bat: Prüft den Live-Zustand des Servers, den PID-Status, den Zustand des Authentifizierungstokens, den Tailscale-Login- und Funnel-Status sowie die Verfügbarkeit der Antigravity-Laufzeitumgebung.

• STOP.bat: Beendet den HTTP-MCP-Serverprozess ordnungsgemäß und deaktiviert die Tailscale-Funnel-Zuordnung.

Hauptfunktionen

1. Unterstützung für zwei Transporte:

   • Stdio-Transport für lokale MCP-Clients (python src/server.py).

   • Streamable-HTTP-Transport für Gemini Spark und entfernte Clients (START.bat / python -m src.http_server).

2. Authentifizierung & Tokenschutz:

   • AuthMiddleware erzwingt die Tokenvalidierung auf /mcp.

   • Unterstützt Authorization: Bearer <token>, x-api-key: <token> oder ?token=<token>.

   • Generiert automatisch ein 32 Zeichen langes Hex-Token, falls es in .env fehlt.

3. Tailscale-Funnel-Integration:

   • Sicherer öffentlicher HTTPS-Endpunkt ohne den Kauf einer Domain.

   • Robuste Erkennung, Statusberichterstattung und Anleitungen zur Fehlerbehebung, wenn Tailscale fehlt oder deaktiviert ist.

4. Lokale Engine für Antigravity 2.0:

   • Integration ohne Konfiguration mit dem lokalen Antigravity Language Server über agentapi.bat.

5. Sicherheit & Arbeitsbereichsisolation:

   • Validierung der Arbeitsbereichsgrenzen zur Verhinderung von Path-Traversal-Angriffen.

   • Automatische Schwärzung geheimer Schlüssel und Tokens aus Ausgabeströmen.

   • Sperrung gleichzeitiger Arbeitsbereichsausführungen zur Verhinderung von Multi-Agent-Konflikten.

Bereitgestellte MCP-Tools

• launch_antigravity_agent: Startet eine Antigravity-Agentenaufgabe, die auf einen lokalen Arbeitsbereich abzielt.

• get_session_status: Prüft den Sitzungsstatus, Zeitstempel und Live-Metadaten.

• list_workspace_artifacts: Indiziert Dateien, Größen, Zeitstempel und SHA256-Hashes im Arbeitsbereich.

• run_antigravity_cli_command: Führt unterstützte agentapi-Unterbefehle aus (get-conversation-metadata, send-message, new-conversation).

Verifizierung & Testsuite

Führen Sie die vollständigen automatisierten Unit- und Integrationstests aus:

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

Führen Sie den realen End-to-End-HTTP-MCP-Integrationstest aus:

.venv\Scripts\python.exe remote_smoke_test.py

Führen Sie den lokalen stdio-Smoke-Test aus:

.venv\Scripts\python.exe smoke_test.py

Dokumentation

Ausführliche Dokumentation finden Sie in docs/:

• docs/remote-access.md: Vollständiger Leitfaden für Fernzugriff, Tailscale Funnel und die Verbindung mit Gemini Spark.

• docs/mcp-setup.md: Client-Konfigurationssnippets für Gemini Spark und Antigravity IDE.

• docs/security.md: Sicherheitsmodell, Pfadvalidierung und Regeln zur Schwärzung von Geheimnissen.

• docs/troubleshooting.md: Troubleshooting-Matrix und Schritte zur diagnostischen Wiederherstellung.

• FINAL-REPORT.md: Vollständiger Integrationsstatusbericht und empirische Verifizierungsmatrix.