Antigravity MCP Bridge (Antigravity 2.0 ↔ Gemini Spark)

Windows 上で Google Antigravity 2.0 エージェントを、Gemini Spark およびリモート/ローカル MCP クライアントを介して、Streamable HTTP と stdio トランスポートでプログラム的に制御します。

アーキテクチャ概要

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

クイックスタート（Windows ワンクリック操作）

• START.bat: 環境を初期化し、安全な認証トークンを含む .env を作成し、127.0.0.1:8000 でバックグラウンド HTTP サーバーを起動し、Tailscale Funnel を有効にして、接続バナーを表示します。

• STATUS.bat: ライブサーバーのヘルス、PID ステータス、認証トークンの状態、Tailscale ログインと Funnel のステータス、および Antigravity ランタイムの可用性を検査します。

• STOP.bat: HTTP MCP サーバープロセスを正常に終了し、Tailscale Funnel マッピングを無効にします。

主な機能

1. デュアルトランスポートサポート:

   • ローカル MCP クライアント用の Stdio トランスポート（python src/server.py）。

   • Gemini Spark およびリモートクライアント用の Streamable HTTP トランスポート（START.bat / python -m src.http_server）。

2. 認証とトークン保護:

   • /mcp でトークン検証を強制する AuthMiddleware。

   • Authorization: Bearer <token>、x-api-key: <token>、または ?token=<token> をサポートします。

   • .env にない場合は、32 文字の 16 進トークンを自動生成します。

3. Tailscale Funnel 統合:

   • ドメインを購入せずに安全なパブリック HTTPS エンドポイントを提供。

   • Tailscale が存在しない、または無効な場合の堅牢な検出、ステータスレポート、および解決ガイダンス。

4. Antigravity 2.0 ローカルエンジン:

   • agentapi.bat を介したローカル Antigravity Language Server とのゼロコンフィグ統合。

5. 安全性とワークスペース分離:

   • パストラバーサル攻撃を防ぐワークスペース境界検証。

   • 出力ストリームからのシークレットキーとトークンの自動編集。

   • マルチエージェントの競合を防ぐ同時ワークスペース実行ロック。

公開されている MCP ツール

• launch_antigravity_agent: ローカルワークスペースを対象とした Antigravity エージェントタスクを起動します。

• get_session_status: セッションのステータス、タイムスタンプ、ライブメタデータを検査します。

• list_workspace_artifacts: ワークスペース内のファイル、サイズ、タイムスタンプ、SHA256 ハッシュをインデックス化します。

• run_antigravity_cli_command: サポートされている agentapi サブコマンド（get-conversation-metadata、send-message、new-conversation）を実行します。

検証とテストスイート

完全な自動単体テストと統合テストを実行:

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

実際のエンドツーエンド HTTP MCP 統合テストを実行:

.venv\Scripts\python.exe remote_smoke_test.py

ローカル stdio スモークテストを実行:

.venv\Scripts\python.exe smoke_test.py

ドキュメント

詳細なドキュメントは docs/ にあります:

• docs/remote-access.md: リモートアクセス、Tailscale Funnel、Gemini Spark 接続の完全なガイド。

• docs/mcp-setup.md: Gemini Spark および Antigravity IDE 用のクライアント設定スニペット。

• docs/security.md: セキュリティモデル、パス検証、シークレット編集ルール。

• docs/troubleshooting.md: トラブルシューティングマトリックスと診断リカバリ手順。

• FINAL-REPORT.md: 完全な統合ステータスレポートと実証検証マトリックス。