Deslord319/zcode-mcp-bridge

Expose ZCode as an agent to any MCP client (zcode / zcode-reply tools, mirrors codex mcp-server)

About zcode-mcp-bridge

把 ZCode 作为完整的智能体(agent)暴露给任意 MCP 客户端 —— 在 Claude Code、Codex、Cursor 或 ZCode 自身里,通过两个工具把复杂编码任务委托给一个独立的 ZCode 智能体去执行。

[!WARNING] 当前默认权限模式是 yolo。 如果调用时没有显式传入 mode 或 sandbox,ZCode 会自动批准工具调用,包括修改文件和执行 shell 命令。处理不可信提示词、重要仓库或生产环境时,请显式使用 mode: "plan" 或 sandbox: "read-only";确认方案后再按需切换到 build / workspace-write。只有在明确接受完全访问风险时才使用 yolo / danger-full-access。

本实现对齐 Codex 官方 mcp-server(codex mcp-server 会暴露 codex / codex-reply 两个工具),本项目提供与之等价的:

Codex mcp-server ZCode MCP Bridge 作用 --------- codex zcode 运行一个新会话 codex-reply zcode-reply 用会话 ID(threadId)继续已有会话

- 零额外运行时依赖:直接驱动 ZCode 安装包内置的 CLI 包(通过 Electron 的 node 模式运行),无需另行安装 Node.js 或任何 Python 包。 - 会话连续性:zcode-reply 通过 --resume 续接,上下文跨调用保持(依赖 ZCode 的持久化会话)。 - 能力继承:无界面会话与桌面端共享同一套插件 / 技能 / MCP 配置。例如启用 ios-simulator 插件后,通过桥接的会话可以直接使用 mcppluginios-simulatorios-simulator 这 20 个 iOS 工具(已实测可用)。

- 完整 MCP 握手(initialize / ping / tools/list / tools/call),标准输入输出传输 - 新建会话 + 会话续接,支持多轮对话(实测单会话连续续接 5 轮正常) - 复杂任务可用:文件读写、Bash 工具、多步任务、中文回复 - 并发:通过 ZCODEMCPMAXCONCURRENCY 限流,实测 6 路并行正常 - 稳定性:连续 / 并行压测 0 失败(详见测试) - 错误处理:参数校验、超时、CLI 异常均以结构化 isError 返回,不会导致服务器崩溃

操作系统 CPU 架构 支持状态 默认发现路径 备注 --------------- macOS Apple Silicon(arm64) 支持 /Applications/ZCode.app、~/Applications/ZCode.app 使用标准 .app/Contents/... 布局 macOS Intel(x64) 支持 /Applications/ZCode.app、~/Applications/ZCode.app 与 Apple Silicon 使用相同的应用布局 Linux ARM64(aarch64) 支持,已验证 /opt/ZCode、~/.local/opt/ZCode 已在 Ubuntu 24.04 ARM64 + ZCode 3.6.5 验证完整 MCP 链路 Linux x64 支持 /opt/ZCode、~/.local/opt/ZCode 使用官方 .deb 安装或将运行时解包至受支持路径 Windows x64 / ARM64 支持 — 已验证完整 MCP 链路

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/Deslord319--zcode-mcp-bridge.html)

Related MCP servers