Antigravity Codex MCP

オンデマンドでOpenAI CodexがGoogle Antigravity CLIに作業を委任できる、管理されたModel Context Protocolブリッジです。

このブリッジは、ユーザーが明示的にCodexにAGYの使用を依頼するまでアイドル状態を維持します。その後、厳密に現在のプロジェクトのみを承認し、プロジェクト単位の会話を保持し、ユーザーに表示される対話を同期し、生成された実装変更を分離されたコピーに限定します。

これは独立したコミュニティプロジェクトです。GoogleやOpenAIとは提携しておらず、その承認も受けていません。

中文说明

ハイライト

• 明示的なオプトイン: ユーザーが依頼しない限り、CodexはAGYを有効化または呼び出せません。

• 厳密なプロジェクト範囲: 広範なルートやシステムディレクトリは拒否されます。

• デフォルトで読み取り専用の委任: AGYの書き込み権限、コマンド権限、URL権限、MCP権限は一切付与されません。

• プロジェクト会話: アクティブな会話IDと委任履歴は、新しいCodexタスクをまたいで保持されます。

• 表示可能なトランスクリプトの同期: AGY CLIを通じて入力されたメッセージは、次の同期時にCodexが利用できるようになります。

• プライベート推論フィルター: thinking/reasoningフィールド、システムメッセージ、チェックポイントは、永続化またはMCPへの返却の前に除外されます。

• 分離された実装: 検証済みのファイル全体の置換は、使い捨てのプロジェクトコピーにのみ適用されます。

• 監査可能な実行: 応答、変更ファイルのマニフェスト、検証出力、サニタイズ済みのツールイベントがローカルに保持されます。

Related MCP server: codex-agy-bridge

要件

• Node.js 20以降

• Antigravity CLI

• MCP対応のOpenAI Codex

Antigravity CLIを認証し、agyが利用可能であることを確認してください:

agy --version
agy -p "Reply exactly: AGY_OK" --output-format json

agyがPATH上にない場合は、MCP設定でAGY_BINにその実行可能ファイルのパスを設定してください。

インストール

git clone https://github.com/ustc-fyk/antigravity-codex-mcp.git
cd antigravity-codex-mcp
npm ci
npm test

サーバーをCodexのconfig.tomlに追加します。例に示すパスを、お使いのマシン上のクローンの絶対パスに置き換えてください:

[mcp_servers.antigravity]
command = 'node'
args = ['C:\path\to\antigravity-codex-mcp\src\index.js']
cwd = 'C:\path\to\antigravity-codex-mcp'
enabled = true
required = false
startup_timeout_sec = 20
tool_timeout_sec = 900
default_tools_approval_mode = 'prompt'
enabled_tools = [
  'antigravity_health',
  'antigravity_project_status',
  'antigravity_enable_project',
  'antigravity_disable_project',
  'antigravity_start_session',
  'antigravity_get_active_session',
  'antigravity_list_sessions',
  'antigravity_sync_conversation',
  'antigravity_get_transcript',
  'antigravity_ask',
  'antigravity_continue',
  'antigravity_review',
  'antigravity_execute',
  'antigravity_list_runs',
  'antigravity_get_run',
]

# Optional when agy is not available on PATH:
[mcp_servers.antigravity.env]
AGY_BIN = 'C:\path\to\agy.exe'

macOSまたはLinuxでは、対応する絶対POSIXパスを使用し、agyがPATH上にある場合は通常AGY_BINを省略します。

同梱のCodex Skillをインストールして、Codexがオプトインワークフローに従うようにします:

$skillRoot = Join-Path $env:USERPROFILE ".codex\skills\agy-project-assistant"
New-Item -ItemType Directory -Force $skillRoot | Out-Null
Copy-Item ".\skills\agy-project-assistant\SKILL.md" $skillRoot

MCP設定を変更した後、またはSkillをインストールした後は、Codexを再起動してください。

使用方法

1. Codexで任意のプロジェクトディレクトリを開きます。

2. 通常どおり作業します。AGYブリッジはアイドル状態のままです。

3. 明示的に依頼します: Load AGY and review this project.

4. Codexはその厳密なプロジェクトへの読み取りアクセスを有効にし、AGYの会話を開始または再利用します。

5. Codexは、分析、レビュー、継続、または分離された実装を適宜委任します。

6. Disable AGY for this projectと依頼すると、ローカルの監査履歴を保持したまま、厳密なプロジェクト権限を取り消します。

同じ会話を直接確認したり参加したりするには:

agy --conversation=<conversation_id>

AGY CLIを通じてメッセージを送信した後、Codexにsync the AGY conversationと依頼します。antigravity_continueも、すべてのフォローアップの前後に同期を実行します。同期はオンデマンドであり、ライブプッシュチャネルではないため、CodexとAGY CLIから同時に送信することは避けてください。

MCPツール

モデル呼び出しは、start、ask、continue、review、executeの各ツールを通じてのみ発生します。ヘルス、ステータス、履歴、実行の検査、トランスクリプトの同期は、AGYのモデルターンを消費しません。

プロジェクトごとのローカル状態

有効化された各プロジェクトには、無視されるローカル状態ディレクトリが作成されます:

.antigravity-mcp/
├── project.json
├── sessions.jsonl
├── transcripts/
│   └── <conversation-id>.jsonl
└── runs/
    └── <run-id>/
        ├── metadata.json
        ├── events.jsonl
        ├── response.md
        └── workspace/

• project.jsonはオプトイン状態とアクティブな会話を記録します。

• sessions.jsonlは委任された呼び出しとトークン使用量を記録します。

• transcriptsには、表示可能なユーザー/アシスタントの記録とサニタイズ済みのツールトレースのみが含まれます。

• runsには、分離された実装ワークスペースと監査結果が含まれます。

このディレクトリはソースコピーから除外され、Gitによって無視されます。プライベートなプロジェクトデータや会話データが含まれる可能性があるため、手動でコミットしないでください。

安全モデル

プロジェクトの有効化は、厳密なルートのみをAntigravityのtrustedWorkspacesおよびread_file(...)許可ルールにアトミックに追加します。無効化は、それらの厳密なエントリのみを削除します。

分離された実装は以下を拒否します:

• 絶対パスと上位ディレクトリへのトラバーサル;

• ファイルの削除;

• シークレットファイル、依存関係、ビルド出力、メタデータ、シンボリックリンク;

• 50を超える変更ファイル;

• 2,000,000文字を超える置換文字数。

トランスクリプトパイプラインは、プロジェクトミラーを書き込む前に、プライベートな推論フィールドを再帰的に削除し、システム/チェックポイントレコードを除外します。報告のガイダンスと制限については、SECURITY.mdを参照してください。

開発

npm ci
npm test
npm run smoke:mcp

ライブチェックには認証済みのAGY CLIが必要であり、モデルのクォータを消費します:

npm run smoke:live
npm run smoke:execute
npm run smoke:project -- "/absolute/path/to/disposable-project"
npm run smoke:continue -- "/absolute/path/to/enabled-project"
npm run smoke:transcript -- "/absolute/path/to/enabled-project"

npm testは自己完結型です。smoke:mcpはローカルのAGYバイナリもチェックしますが、残りのスモークテストはプロジェクトの承認を変更したり、クォータを消費したりする可能性があります。

ライセンス

MIT