nexus-mcp

nexus-mcp

コーディングエージェントにタスクを委任する MCP サーバーです。Claude Agent SDK 経由の Claude Code、Codex App Server 経由の Codex、および Antigravity SDK 経由の Antigravity を、任意の MCP クライアントから利用できます。

インストール

バックエンドは任意の追加機能です。使用するものをインストールしてください。

追加機能	バックエンド	追加されるもの
claude	Claude Agent SDK	claude-agent-sdk（Claude Code CLI を同梱、約 100 MB）
codex	Codex App Server	openai-codex（Codex CLI を同梱、約 120～150 MB）
antigravity	Antigravity SDK	google-antigravity（Antigravity Go ハーネスを同梱、約 40 MB）
all	すべてのバックエンド

uvx --with 'nexus-mcp[all]' nexus-mcp          # run directly
pip install 'nexus-mcp[claude]'                 # or install
pip install 'nexus-mcp[codex]'                  # Codex only
pip install 'nexus-mcp[antigravity]'

Claude Code の MCP 設定：

{ "mcpServers": { "nexus": { "command": "uvx", "args": ["--with", "nexus-mcp[all]", "nexus-mcp"] } } }

認証には各エージェント固有の方法を使用します。claude でログインするか、ANTHROPIC_API_KEY を設定してください。Codex の場合は、codex login でログインします（~/.codex 内の認証情報が共有されます）。Antigravity では GEMINI_API_KEY を使用するか、GOOGLE_GENAI_USE_VERTEXAI、GOOGLE_CLOUD_PROJECT、および GOOGLE_CLOUD_LOCATION を設定して Vertex AI を使用し、Application Default Credentials（ADC）で認証します。Google アカウントでのログインは使用しません。

Windows： 最近の claude-agent-sdk リリースには、CLI を同梱した Windows 用ホイールがありません。claude が PATH に含まれるように Claude Code をインストールしてください。

ツール：prompt

エージェントの 1 ターンを実行し、最終回答を返します。

パラメーター	デフォルト	説明
backend	必須	claude、codex、または antigravity
prompt	必須	エージェントに実行させるタスク
cwd	必須	プロジェクトの絶対パス
profile	read_only	権限プロファイル（下記参照）
session_id	—	この会話を続行します
fork	false	session_id から新しい会話を分岐します
model	プロバイダーのデフォルト	モデル ID またはエイリアス
timeout	600	ターンがキャンセルされるまでの秒数

{backend, session_id, output, usage} を返します。会話はエージェント自身が保存するため（~/.claude/projects、$CODEX_HOME/sessions、~/.nexus-mcp/antigravity）、session_id は nexus-mcp の再起動後も引き続き使用できます。Antigravity は fork=true をサポートしていません。

権限プロファイル

選択したプロファイルの範囲外の操作は自動的に拒否され、確認は求められません。

プロファイル	許可される操作
read_only	Read/Glob/Grep、--no-ext-diff --no-textconv を指定した git diff/log/show
workspace_write	上記に加え、cwd 内のファイル編集と OS サンドボックス内の Bash
full_access	すべて

Codex は OS サンドボックス（read-only、workspace-write、danger-full-access）でプロファイルを適用し、承認を求めることはありません。

Antigravity はハーネス内でワークスペースの範囲を制限し、コマンドには OS サンドボックスを使用します。サンドボックスを利用できない場合、workspace_write は失敗します。

リソース：nexus://backends

{name, installed, models, hint} の JSON リストです。hint には、インストールされていない追加機能のインストールコマンドが含まれます。Codex はモデルを一覧表示します。Claude と Antigravity は null を返します（Antigravity はモデル一覧を提供しません）。

設定

変数	デフォルト	説明
NEXUS_CLAUDE_SETTINGS_PROFILE	isolated	読み込む Claude 設定：isolated（なし）、project（プロジェクトの .claude/）、inherit（ユーザー設定を含むすべて）。どのプロファイルでも、すべてのツール呼び出しには制限が適用されます。

v1 からの移行

v1	v2
prompt(cli="codex") (codex exec)	prompt(backend="codex", cwd=…)（App Server）
prompt(cli=…, execution_mode="yolo")	prompt(backend=…, profile="full_access", cwd=…)
batch_prompt	クライアントからの並列 prompt 呼び出し
agent_start / agent_status / agent_result	prompt（同期）
agent_continue / agent_fork	prompt(session_id=…) / prompt(session_id=…, fork=true)
agent_review	prompt(profile="read_only", prompt="Review …")
agent_cancel	クライアントでツール呼び出しをキャンセル
agent_respond、elicitation	削除 — 代わりにプロファイルを選択してください
設定、モデルティア、MCP プロンプト	削除
OpenCode ランナーとツール	削除
NEXUS_* 変数	NEXUS_CLAUDE_SETTINGS_PROFILE を除き削除

開発

uv sync --all-extras --all-groups
uv run pytest                    # unit + e2e
uv run pytest -m integration     # real CLI (slow, makes model calls)
uv run mypy src/nexus_mcp && uv run ruff check . && uv run ruff format --check .

ライセンス

MIT