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 分