nexus-mcp

nexus-mcp

可将任务委派给编码 Agent 的 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 harness，约 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"] } } }

使用 Agent 自身的身份验证：使用 claude 登录，或设置 ANTHROPIC_API_KEY；对于 Codex，使用 codex login 登录（共享 ~/.codex 中的凭据）。Antigravity 使用 GEMINI_API_KEY，或通过 Application Default Credentials (ADC) 进行身份验证的 Vertex AI，并设置 GOOGLE_GENAI_USE_VERTEXAI、GOOGLE_CLOUD_PROJECT 和 GOOGLE_CLOUD_LOCATION。它不使用 Google 账号登录。

**Windows：**近期的 claude-agent-sdk 版本不再提供捆绑 CLI 的 Windows wheel；请安装 Claude Code，确保 claude 位于 PATH 中。

工具：prompt

运行一轮 Agent 对话并返回最终答复。

参数	默认值	含义
backend	必填	claude、codex 或 antigravity
prompt	必填	给 Agent 的任务
cwd	必填	项目的绝对路径
profile	read_only	权限配置（见下文）
session_id	—	继续此对话
fork	false	将 session_id 分支为新对话
model	提供方默认值	模型 ID 或别名
timeout	600	取消本轮对话前的秒数

返回 {backend, session_id, output, usage}。对话由 Agent 自身存储（~/.claude/projects、$CODEX_HOME/sessions、~/.nexus-mcp/antigravity），因此 nexus-mcp 重启后，session_id 仍可继续使用。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 通过其 harness 限制工作区范围，并使用 OS 沙箱运行命令。如果 OS 沙箱不可用，workspace_write 将失败。

资源：nexus://backends

JSON 列表，包含 {name, installed, models, hint}；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