Nexus Mcp

io.github.j7an由 GitHub 账号 j7an 发布v2.1.3更新于 Oct 25, 2026

Delegate tasks to coding agents (Claude, Codex, Antigravity) from any MCP client

已验证STDIO仅桌面开发者工具AI 与机器学习

概览

AI 生成的概览

本地 MCP 服务器，让任意 MCP 客户端把编码任务交给 Claude Code、Codex 或 Antigravity 代理，并取回最终结果。

可以做什么
在指定后端（claude、codex 或 antigravity）上运行一次代理回合，传入提示词和绝对项目目录，返回输出、会话 ID 与用量信息。按会话 ID 继续或分叉对话，选择模型并设置超时。用权限配置约束每次调用：read_only、workspace_write 或 full_access。以资源形式列出可用后端，显示已安装的附加组件、模型和安装提示。
适用场景
适合希望 MCP 客户端把编码或审查工作交给外部编码代理、而不是自己完成的场景，包括只读审查和项目目录内的沙箱编辑。
运行要求
通过 uvx 或 pip 在本地运行；每个后端是可选附加组件，会捆绑各自的 CLI（约 40–150 MB）。认证由代理自身负责：Claude 登录或 ANTHROPIC_API_KEY，codex login，Antigravity 使用 GEMINI_API_KEY 或 Vertex AI 变量配合 ADC。Windows 上需确保 Claude Code 在 PATH 中。
安装前请注意
full_access 配置允许代理在项目中执行任何操作，workspace_write 允许编辑文件并在沙箱中运行 Bash；被拒绝的操作会直接拒绝而不询问。代理凭据和会话数据存放在各代理自己的目录中。模型调用可能产生提供商费用。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Nexus Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

nexus-mcp

MCP server that delegates tasks to coding agents — Claude Code via the Claude Agent SDK, Codex via the Codex App Server, and Antigravity via the Antigravity SDK — from any MCP client.

Install

Backends are optional extras; install the ones you use.

ExtraBackendAdds
claudeClaude Agent SDKclaude-agent-sdk (bundles the Claude Code CLI, ~100 MB)
codexCodex App Serveropenai-codex (bundles the Codex CLI, ~120–150 MB)
antigravityAntigravity SDKgoogle-antigravity (bundles the Antigravity Go harness, ~40 MB)
allevery backend
bash
uvx --with 'nexus-mcp[all]' nexus-mcp          # run directlypip install 'nexus-mcp[claude]'                 # or installpip install 'nexus-mcp[codex]'                  # Codex onlypip install 'nexus-mcp[antigravity]'

Claude Code MCP config:

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

Authentication is the agent's own: log in with claude, or set ANTHROPIC_API_KEY; for Codex, log in with codex login (credentials in ~/.codex are shared). Antigravity uses GEMINI_API_KEY, or Vertex AI with GOOGLE_GENAI_USE_VERTEXAI, GOOGLE_CLOUD_PROJECT, and GOOGLE_CLOUD_LOCATION, authenticated through Application Default Credentials (ADC). It does not use Google-account login.

Windows: recent claude-agent-sdk releases ship no Windows wheel with a bundled CLI; install Claude Code so claude is on PATH.

Tool: prompt

Runs one agent turn and returns its final answer.

ParameterDefaultMeaning
backendrequiredclaude, codex, or antigravity
promptrequiredTask for the agent
cwdrequiredAbsolute project directory
profileread_onlyPermission profile (below)
session_id—Continue this conversation
forkfalseBranch session_id into a new conversation
modelprovider defaultModel id or alias
timeout600Seconds before the turn is cancelled

Returns {backend, session_id, output, usage}. Conversations are stored by the agent itself (~/.claude/projects, $CODEX_HOME/sessions, ~/.nexus-mcp/antigravity), so a session_id keeps working after nexus-mcp restarts. Antigravity does not support fork=true.

Permission profiles

Actions outside the chosen profile are denied automatically — nobody is prompted.

ProfileAllows
read_onlyRead/Glob/Grep; git diff/log/show with --no-ext-diff --no-textconv
workspace_writePlus file edits inside cwd and Bash inside the OS sandbox
full_accessEverything

Codex enforces profiles with its OS sandbox (read-only, workspace-write, danger-full-access) and never asks for approval.

Antigravity enforces workspace containment in its harness and uses the OS sandbox for commands. workspace_write fails if that sandbox is unavailable.

Resource: nexus://backends

JSON list of {name, installed, models, hint}; hint gives the install command for a missing extra. Codex lists its models; Claude and Antigravity report null (Antigravity does not provide a model list).

Configuration

VariableDefaultMeaning
NEXUS_CLAUDE_SETTINGS_PROFILEisolatedClaude settings to load: isolated (none), project (project .claude/), inherit (all, including user settings). Profiles still bound every tool call.

Migrating from v1

v1v2
prompt(cli="codex") (codex exec)prompt(backend="codex", cwd=…) (App Server)
prompt(cli=…, execution_mode="yolo")prompt(backend=…, profile="full_access", cwd=…)
batch_promptParallel prompt calls from the client
agent_start / agent_status / agent_resultprompt (synchronous)
agent_continue / agent_forkprompt(session_id=…) / prompt(session_id=…, fork=true)
agent_reviewprompt(profile="read_only", prompt="Review …")
agent_cancelCancel the tool call in the client
agent_respond, elicitationRemoved — choose a profile instead
Preferences, model tiers, MCP promptsRemoved
OpenCode runners and toolsRemoved
NEXUS_* variablesRemoved except NEXUS_CLAUDE_SETTINGS_PROFILE

Development

bash
uv sync --all-extras --all-groupsuv run pytest                    # unit + e2euv 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 .

License

MIT

来源：README.md，提交 e9204e9

工具

0
SourceWeft 曾在隔离沙箱中以无凭据方式启动该软件包一次，以列出其工具，但未能完成：软件包安装失败。

版本历史

9
  1. v2.1.3最新Oct 25, 2026
  2. v2.1.2Oct 17, 2026
  3. v2.1.1Oct 3, 2026
  4. v2.1.0Oct 3, 2026
  5. v2.0.2Oct 2, 2026
  6. v2.0.1Sep 26, 2026
  7. v2.0.0Sep 26, 2026
  8. v1.1.0Sep 19, 2026
  9. v1.0.3Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分