MCP 服务器

opencode-delegator

MCP server that delegates code writing, editing, and execution to OpenCode, allowing AI assistants to focus on decision-making.

README

OpenCode Delegator

MCP Server — 让 Codex、Claude Code 等 AI 编码助手只做决策，将代码编写、编辑、执行全部委派给 OpenCode。

快速开始

安装

npm install -g opencode-delegator

或直接使用 npx：

npx opencode-delegator

前置要求

Node.js >= 18
OpenCode CLI 已安装并在 PATH 中

配置

Codex CLI — 编辑 ~/.codex/config.toml：

[mcp_servers.opencode]
command = "npx"
args = ["-y", "opencode-delegator"]
env = { OPENCODE_DEFAULT_PROJECT = "/path/to/project" }

Claude Code：

claude mcp add opencode -- npx -y opencode-delegator

Claude Desktop — 编辑配置文件：

{
  "mcpServers": {
    "opencode": {
      "command": "npx",
      "args": ["-y", "opencode-delegator"],
      "env": { "OPENCODE_DEFAULT_PROJECT": "/path/to/project" }
    }
  }
}

环境变量

变量	默认值	说明
`OPENCODE_MODE`	`spawn`	`spawn` 或 `persistent`
`OPENCODE_DEFAULT_PROJECT`	-	默认项目绝对路径
`OPENCODE_PATH`	`opencode`	OpenCode 可执行文件路径
`OPENCODE_TIMEOUT`	`120000`	超时时间 (ms)
`OPENCODE_WHITELIST`	`false`	启用命令白名单
`OPENCODE_PROJECTS`	-	JSON 格式多项目配置

也支持配置文件 opencode-delegator.json，参见 config.example.json。

工具

工具	说明
`write_code`	创建/覆写文件（支持 AI 生成）
`edit_code`	通过 OpenCode 编辑文件（自动 lint/typecheck）
`read_file`	读取文件内容
`search_code`	ripgrep 搜索代码库
`run_command`	执行 shell 命令（带安全过滤）
`run_tests`	运行测试套件（自动检测框架）
`git_status`	查看分支和文件状态
`git_diff`	查看 diff
`git_commit`	暂存并提交
`git_log`	查看提交历史
`plan`	OpenCode 分析需求并输出方案
`execute_plan`	执行已生成的方案
`list_projects`	列出已注册项目
`add_project`	动态注册新项目
`list_sessions`	列出活跃会话（persistent）
`resume_session`	恢复历史会话（persistent）
`ask_opencode`	通用委派工具

MCP Resources

资源	URI	说明
project-structure	`project://{project}/structure`	项目文件树
project-dependencies	`project://{project}/dependencies`	依赖信息
project-recent	`project://{project}/recent`	最近 git 变更

安全

路径校验：所有文件操作限制在项目目录内，防止路径遍历
命令过滤：拦截危险 shell 命令（rm -rf /、curl | sh 等），支持白名单模式
审计日志：所有工具调用记录到 ~/.opencode-delegator/audit.jsonl

架构

┌─────────────────┐      MCP (stdio)      ┌──────────────────┐
│   Codex CLI     │ ◄────────────────────► │  opencode-       │
│   Claude Code   │                        │  delegator       │
│   Cursor 等     │                        │  (MCP Server)    │
└─────────────────┘                        └────────┬─────────┘
                                                    │
                                    ┌───────────────┼───────────────┐
                                    ▼               ▼               ▼
                              ┌──────────┐   ┌──────────┐   ┌──────────┐
                              │ Project A │   │ Project B │   │ Project C │
                              └──────────┘   └──────────┘   └──────────┘