Antigravity Sub-Agent Bridge (FastMCP)

コンテナ化されたFastMCPサーバーで、Google Antigravity CLI (agy --headless) をSSE経由のリモートModel Context Protocol (MCP)ツールとして公開します。

このブリッジにより、会話型AIクライアント（Google Spark、Claude、Cursor、ChatGPTなど）は、サンドボックス化されたコンテナ・ワークスペース内で本格的なコーディングおよび自動化サブエージェントをディスパッチできます。

🚀 主な機能

• 同期サブエージェント実行 (execute_antigravity_sync): agy --headless にコーディング/自動化タスクを直接ディスパッチし、エージェントの完了後に出力ログを返します（1〜3分の短いタスクに最適）。

• 非同期バックグラウンド実行 (start_antigravity_async): 長時間実行されるAntigravityエージェントをバックグラウンドで起動し、分離された実行のための task_id を返します。

• タスクのポーリングと管理 (get_antigravity_task_status, list_antigravity_tasks): 進行状況をポーリングし、ログを検査し、すべてのバックグラウンド・サブエージェントを一覧表示します。

• ワークスペースの分離とサンドボックス化: ホストシステムのファイルを保護しつつ、エージェントがそのサンドボックス内で自由にビルド・テスト・実行できるように、./workspaces のみをマウントしたDockerコンテナ内で実行します。

• mcp-server-oauth-proxy とのシームレスな統合: ポート 8080/sse で標準のSSEエンドポイントを公開し、Google Sparkからの安全なアクセスのためにHome AssistantのOAuthプロキシに直接プラグインできます。

Related MCP server: agy-mcp

🛠️ リポジトリ構成

antigravity-mcp-bridge/
├── Dockerfile              # Container image with Python 3.12, Node.js, git, & agy CLI
├── docker-compose.yml      # Service definitions with volume mounts & port bindings
├── requirements.txt        # fastmcp, mcp[cli], pydantic
├── server.py               # FastMCP Server exposing Antigravity agent tools
├── .env.example            # Environment variable template
├── .gitignore              # Ignored artifacts & workspace directories
└── README.md               # Documentation

📦 クイックスタートとデプロイ

1. 環境を設定する

.env.example テンプレートをコピーします:

cp .env.example .env

(オプション: agy 環境で必要な場合は、GEMINI_API_KEY または ANTIGRAVITY_API_KEY を追加してください)。

2. Docker Composeで起動する

docker compose up -d --build

FastMCPサーバーは次の場所でリッスンを開始します: 👉 http://localhost:8080/sse (またはホストのLAN IP)。

3. コンテナのヘルスチェック

docker compose logs -f

🔗 mcp-server-oauth-proxy に接続する

このAntigravityサブエージェントブリッジを、Home AssistantのOAuthプロキシ経由でGoogle Sparkに安全に公開するには:

1. Home Assistantで、設定 > アドオン > MCP Server OAuth Proxy > 構成 を開きます。

2. servers の下に新しいサーバーエントリを追加します:

    - client_name: "Google Spark"
      server_name: "Antigravity Bridge"
      server_url: "http://<YOUR_DOCKER_HOST_IP>:8080/sse"
      bearer_token: ""
      client_id: "spark-antigravity"
      client_secret: "secret-antigravity"
      allowed_redirect_uris: "https://oauth-redirect.googleusercontent.com"
      host: "antigravity-oauth.yourdomain.com"
      path_prefix: ""

3. 保存してアドオンを再起動します。

4. Google Sparkで、クライアントID spark-antigravity を使用して https://antigravity-oauth.yourdomain.com/sse を指すカスタムツールを追加します。

🧰 利用可能なMCPツール

1. execute_antigravity_sync

• 説明: agy --headless 経由でタスクを同期的に実行し、出力を待ちます。

• パラメータ:

  • prompt (string, required): ゴールまたはコーディング指示。

  • sub_path (string, optional): /workspace 内で実行するサブディレクトリ。

  • timeout_seconds (int, default: 300): 中止するまで待機する最大秒数。

2. start_antigravity_async

• 説明: Antigravityタスクをバックグラウンドで開始し、task_id を返します。

• パラメータ:

  • prompt (string, required): ゴールまたはコーディング指示。

  • sub_path (string, optional): /workspace 内で実行するサブディレクトリ。

3. get_antigravity_task_status

• 説明: バックグラウンドタスクの進行状況と完全なログを検査します。

• パラメータ:

  • task_id (string, required): start_antigravity_async が返す8文字のID。

4. list_antigravity_tasks

• 説明: アクティブおよび完了したすべてのバックグラウンドタスクを一覧表示します。