agy MCP Bridge セットアップ手順 (Claude Code × Antigravity CLI)

agy-mcp-bridge-setup.md

agy MCP Bridge セットアップ手順 (Claude Code × Antigravity CLI)

agy MCP Bridge セットアップ手順

Claude Code から Antigravity CLI (agy) を MCP 経由でサブエージェントとして呼び出すためのセットアップ手順。

背景

Antigravity CLI (agy) は MCP サーバー機能を持たないため、Claude Code から MCP ツールとして呼び出すにはブリッジ層が必要になる。このブリッジは agy を MCP エコシステムに統合するアダプタとして機能し、以下を担う:

• agy の print mode (-p) を MCP ツールとしてラップ
• TTY 分離により agy の出力が Claude Code の TUI に漏れるのを防止
• transcript.jsonl から構造化レスポンスを読み取り (-p の stdout バグ issue#76 の回避を含む)
• Watch モード / Swarm ダッシュボードによるリアルタイム進捗表示

参考:

• 参考記事: https://qiita.com/fallout/items/5097f0575b58f4c69b81
• 参考記事: https://qiita.com/fallout/items/d699df3d6931c07eb38d
• ブリッジ本体 (上流): https://github.com/SinanTufekci/Claude-Code-Antigravity-CLI-MCP-Server
• フォーク (安全性レビュー済み): https://github.com/kuchida1981/antigravity-intern

前提条件

• Claude Code がインストール済み
• Antigravity CLI (agy) がインストール・認証済み (agy -i で対話ログインが完了していること)
• Python 3.10+

セットアップ手順

1. ブリッジをクローン

mkdir -p ~/opt/tools
cd ~/opt/tools
git clone https://github.com/kuchida1981/antigravity-intern.git agy-mcp-bridge
cd agy-mcp-bridge
git remote add upstream https://github.com/SinanTufekci/Claude-Code-Antigravity-CLI-MCP-Server.git

2. Python 仮想環境を作成し fastmcp をインストール

cd ~/opt/tools/agy-mcp-bridge
python3 -m venv .venv
.venv/bin/pip install fastmcp

3. agyのPATH確認

which agy
# 出力例: /home/<user>/.local/bin/agy

PATH に入っていない場合は、ステップ4で環境変数 AGY_BIN を設定する。

4. Claude Code に MCP サーバーを登録

agyがPATHに入っている場合:

claude mcp add agy -s user -- \
  ~/opt/tools/agy-mcp-bridge/.venv/bin/python \
  ~/opt/tools/agy-mcp-bridge/server.py

agyがPATHに入っていない場合 (環境変数でパスを指定):

claude mcp add agy -s user \
  -e AGY_BIN=/path/to/agy \
  -- \
  ~/opt/tools/agy-mcp-bridge/.venv/bin/python \
  ~/opt/tools/agy-mcp-bridge/server.py

Windows の場合:

$env:AGY_BIN = "$env:LOCALAPPDATA\agy\bin\agy.exe"
claude mcp add agy -s user `
  -e AGY_BIN="$env:AGY_BIN" `
  -- `
  "path\to\agy-mcp-bridge\.venv\Scripts\python.exe" `
  "path\to\agy-mcp-bridge\server.py"

5. スモークテスト

cd ~/opt/tools/agy-mcp-bridge
.venv/bin/python test_smoke.py

全4テスト (ask, continue, image, swarm) がPASSすればOK。

6. Claude Code を再起動

MCP サーバーは起動時に読み込まれるので、Claude Code を再起動する。

動作確認

新しい Claude Code セッションで以下を試す:

agyのステータスを確認して (mcp__agy__antigravity_status)

レスポンスが返ればセットアップ完了。

利用可能な MCP ツール

ツール	用途
mcp__agy__antigravity_ask	新規会話でタスク委譲
mcp__agy__antigravity_continue	同一ワークスペースで会話継続
mcp__agy__antigravity_image	画像生成
mcp__agy__antigravity_status	診断 (クォータ消費なし)

agyのモデル設定

ブリッジはagyの settings.json に設定されたモデルを使用する (--model フラグは print mode でハングするため非対応)。

cat ~/.gemini/antigravity-cli/settings.json
# "model" フィールドを確認・変更

上流アップデートの取り込み

上流 (SinanTufekci/Claude-Code-Antigravity-CLI-MCP-Server) に更新があった場合、以下の手順で安全に取り込む。

1. 上流の変更を取得 (マージはしない)

cd ~/opt/tools/agy-mcp-bridge
git fetch upstream

2. 差分を確認

# 変更されたファイル一覧
git diff --stat main..upstream/main

# 変更内容の詳細 (コードレビュー)
git diff main..upstream/main

3. 安全性チェック

以下の観点で差分をレビューする:

• コマンドインジェクション: subprocess, os.system, eval, exec, shell=True の追加がないか
• 外部通信の追加: 新たな HTTP リクエストや外部APIコールがないか
• ファイルアクセス範囲の変更: ~/.gemini/ 外のファイルへのアクセスが追加されていないか
• 秘密情報の扱い: APIキーやトークンのハードコードがないか
• 依存関係の変更: pyproject.toml に不審な依存が追加されていないか
• 難読化コード: base64エンコード文字列や意図的に読みにくいコードがないか

Claude Code を使ってレビューする場合:

上流の差分を安全性の観点でレビューして:
git diff main..upstream/main

4. 問題がなければマージ

git merge upstream/main

コンフリクトがあれば解消し、スモークテストを再実行する:

.venv/bin/python test_smoke.py

5. フォークに反映

git push origin main

トラブルシューティング

MCP サーバーが認識されない

claude mcp list

agy が表示されなければ登録をやり直す。

スモークテストが失敗する

• agy -i で対話ログインが完了しているか確認
• agy --version が動くか確認
• Python venv 内に fastmcp がインストールされているか確認: .venv/bin/pip list | grep fastmcp

MCP登録の削除

claude mcp remove agy -s user