mcp-server-google-antigravity

   ____ _                 _
  / ___| | __ _ _   _  __| | ___
 | |   | |/ _` | | | |/ _` |/ _ \
 | |___| | (_| | |_| | (_| |  __/
  \____|_|\__,_|\__,_|\__,_|\___|

               |
          +----+----+
          |   MCP   | (- you are here
          +----+----+
               |

     _          _   _                       _ _
    / \   _ __ | |_(_) __ _ _ __ __ ___   _(_) |_ _   _
   / _ \ | '_ \| __| |/ _` | '__/ _` \ \ / / | __| | | |
  / ___ \| | | | |_| | (_| | | | (_| |\ V /| | |_| |_| |
 /_/   \_\_| |_|\__|_|\__, |_|  \__,_| \_/ |_|\__|\__, |
                      |___/                       |___/

これは何ですか？

mcp-server-google-antigravity は、小規模な MCP（Model Context Protocol）サーバーです。agy CLI（内部で Gemini を使用）で動作する Google のターミナル向けコーディングエージェント、Google Antigravity を、任意の MCP クライアントから呼び出せる一連のツールとして公開します。

仕組みはシンプルです。プライマリモデル（Claude Desktop、Claude Code、Codex など）は軽快なまま、ウェブ検索、リポジトリ全体の分析、ファイルのひな形作成、長時間かかる編集といった面倒な作業を、バックグラウンドで実行される別のエージェントに任せます。ジョブは非同期で無制限です。タスクを送信するとすぐに jobId が返され、呼び出し元で作業を続けながら結果をポーリングできます。

   Claude / Codex          this MCP server            Antigravity
  +---------------+  tool  +----------------+ spawns  +--------------+
  |  "analyze the | -----> | use_antigravity| ------> | agy  --print |
  |   whole repo" |        | -> jobId(async)|         | (Gemini)     |
  +---------------+ <----- +----------------+ <------ +--------------+
        keeps working        polls result / logs        does the work

要件

ステップ 1 — Antigravity CLI（agy）をインストールする

agy を使ったことがありませんか？まずはこちらから。コマンドは 1 つです。初回起動時に Google アカウントでサインインします。

macOS / Linux

curl -fsSL https://antigravity.google/cli/install.sh | bash

Windows（PowerShell）

irm https://antigravity.google/cli/install.ps1 | iex

Windows（CMD）

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

インストール先（覚えておいてください。以下の AGY_PATH で必要になる場合があります）：

サインインして確認する：

agy            # first run opens a Google Sign-In in your browser (creds cached in your OS keyring)
agy --version  # should print a version, e.g. 1.1.1
agy models     # lists the models you can use (Gemini 3.5 Flash, Gemini 3.1 Pro, ...)

その後 agy が見つからない場合は、新しいターミナルを開いて（PATH を再読み込みして）ください。または agy install を実行して、シェルのパスを修正してください。

ステップ 2 — この MCP サーバーを入手する

オプション A — npx（推奨）： ステップ 3 に進み、npx の設定を使用します。npx は認証不要で、公開 npm レジストリからシームレスに利用できます。

または、パッケージをグローバルにインストールできます：

npm install -g mcp-server-google-antigravity

これにより mcp-server-google-antigravity コマンドが利用可能になります（npx の代わりに、MCP クライアントの設定へ直接登録できます）。

オプション B — ソースから（開発する場合）：

git clone https://github.com/TurkerYakup/mcp-server-google-antigravity.git
cd mcp-server-google-antigravity
npm install
npm run check   # quick syntax check

node-pty（Windows で出力を整える場合にのみ使用）はオプションの依存関係です。macOS／Linux でビルドできなくてもインストールは成功し、サーバーは自動的にフォールバックします。コンパイラーは不要です。

ステップ 3 — MCP クライアントに登録する

{
  "mcpServers": {
    "antigravity": {
      "command": "npx",
      "args": ["-y", "mcp-server-google-antigravity"],
      "env": {
        "AGY_MODEL": "Gemini 3.5 Flash (Medium)",
        "AGY_AUTO_APPROVE": "true"
      },
      "timeout": 900000
    }
  }
}

# npx (Option A)
claude mcp add antigravity -- npx -y mcp-server-google-antigravity

# from source (Option B)
claude mcp add antigravity -- node /absolute/path/to/mcp-server-google-antigravity/index.js

これで完了です。クライアントから use_antigravity、antigravity_continue、ファイルシステムヘルパーなどのツールを利用できます。

簡単な例

MCP クライアントに、「antigravity を使って C:/Dev/Repos/foo のリポジトリを分析し、そのアーキテクチャを要約して」 といった内容を尋ねてみてください。内部では、クライアントが次のように呼び出します。

1. use_antigravity({ prompt: "...", add_dirs: ["C:/Dev/Repos/foo"] }) → { "jobId": "mrib1q20_wa5ma1", "status": "running" } を即座に返します。
2. antigravity_result({ jobId, wait_ms: 10000 }) → ジョブが完了するか、10 秒の待機時間が経過するまでブロック／ロングポーリングします。処理中は、ステータス、文字数、出力の末尾 200 文字を含む簡潔なペイロード（{ status, jobId, chars, tail, startedAt }）を返します。完了すると、durationMs と bytes のテレメトリーを含む全レコードを返します。

同じセッションで antigravity_continue({ prompt: "now list the top 3 risks" }) を使って続けてください。agy にファイルを書き込ませる必要がありますか？add_dirs を渡してワークスペースを設定してください。auto_approve（デフォルト）を有効にすると、確認プロンプトなしでファイルを作成／編集できます。

設定（環境変数）

すべて任意です。初期設定のままでも適切な値が使用されます。

ツール

サーバー側のファイルシステムツールは Node の fs を直接使用するため、即時に実行され、権限確認プロンプトで止められることもありません。

ライブ進行状況通知

ジョブはすぐに jobId を返すため、サーバーは MCP のログ通知（notifications/message、ロガー antigravity）をプッシュします。これにより、クライアントはポーリングせずに処理状況を確認できます。

• job started — jobId、種類、プロンプトの抜粋
• job running — AGY_HEARTBEAT_MS（デフォルト 15s）ごとのハートビート。現在の出力の末尾を含みます
• job done / job failed — 最終ステータス、バイト数／エラー

ベストエフォートです。クライアントが logging 機能をネゴシエートしていない場合、通知は何も表示されずに破棄されます。どちらの場合も antigravity_result のポーリングは機能します。

仕組み（設計上の注意点）

agy CLI は agy --print "<prompt>" で単一のプロンプトを実行し、完了すると戻ります。問題点は 3 つあり、それぞれ次のように対処しています。

1. MCP クライアントのリクエストタイムアウト（約60秒）。 agy が実行を続けていても、長時間のタスクではクライアントが諦めてしまいます。→ 非同期ジョブパターン： use_antigravity は agy をバックグラウンドで起動し、すぐに jobId を返します。結果は OS の一時ディレクトリー内の JSON ファイル（agy_jobs/）に書き込まれ、クライアントは antigravity_result をポーリングします。任意のロングポーリング（wait_ms）を使うと、短時間で完了する見込みの処理については、リクエスト内で待機できます。リクエストがブロックされることはありません。
2. agy 自身の print タイムアウト（デフォルト 5m）。 負荷の高いプロンプトでは timeout waiting for response が発生します。→ 各ジョブで --print-timeout 10m を渡します。
3. ヘッドレス時のファイル権限ゲート。 --print モードでは、agy のファイル書き込みが「ask」ポリシーによって拒否され、ジョブが停止します。→ auto_approve（デフォルト true）は --dangerously-skip-permissions を渡し、add_dirs は必要なワークスペースに対して --add-dir <path> を渡します。

セキュリティに関する注意

auto_approve のデフォルトは true（--dangerously-skip-permissions）です。agy は確認なしでファイルを作成／編集し、ターミナルコマンドを実行します。これは意図的な動作です。ヘッドレスの --print モードでは、これを設定しないと agy が権限確認プロンプトで停止し、ジョブが止まってしまうためです。信頼できないプロンプトには、auto-approve を無効にするよりも sandbox: true（ターミナルを制限する軽量な権限レイヤーであり、VM ではありません）をおすすめします。auto_approve: false は、本当に読み取り専用の依頼に限って使用してください。

プラットフォーム対応

完全なクロスプラットフォーム対応です。macOS、Windows、Linux に対応しています。Windows では、安定したストリーミングのために node-pty を使用する経路を用意しており、利用できない場合は自動的にフォールバックします。また、ASCII 以外の文字を含むユーザー名に対して、8.3 形式の短いパスを自動的に解決します。macOS/Linux では通常の child_process を使用します。OS ごとの違いは、agy の場所とクライアントの設定ファイルの場所だけです（どちらも上記で説明しています）。

トラブルシューティング

ライセンス

MIT © Türker Yakup Altınsoy。