worker-mcp
Enables Claude to delegate coding tasks to a worker CLI, handling actual code modifications and command execution while Claude supervises and verifies results.
README
worker-mcp
一个 stdio MCP server，让 Claude Code（或任何 MCP 客户端）把编码任务委派给一个 worker CLI 执行。调用方（Claude）只做计划、监督和验收，worker 负责所有实际的 代码修改和命令执行。
原理
server 通过子进程调用 <worker-cli> -p <prompt> --output-format stream-json（无头模式），
解析其 stream-json 输出，把 worker 的最终回复和 session_id 返回给调用方。
默认 worker 是 Kimi Code CLI（kimi），可通过环境变量 WORKER_CLI_BIN 换成任何
兼容同一 CLI 契约的执行器：支持 -p 无头执行、-S <id> / -c 会话续接，
并以 stream-json 逐行输出 role=assistant（回复）和 role=meta（session_id）事件。
注意：worker 无头模式会自动批准所有工具调用（等同于 yolo），
可以在指定 cwd 内自由读写文件、执行命令。请只把可信的项目目录传给 cwd。
工作模式：Claude 监督计划，worker 执行
server 在 MCP instructions 和工具描述中写明了分工，Claude Code 连接后会自动遵循：
- Claude（监督/计划）：拆解目标、决定步骤顺序、为每步编写自包含任务书
（背景、涉及文件、改什么、验收标准——worker 看不到 Claude 的上下文）、
验收每步结果（读文件/diff、让 worker 跑测试）、失败时用
worker_continue打回重修。 - worker（执行）：在指定
cwd内完成所有实际的代码修改和命令执行。
Claude 被引导不自己调用 Edit/Write 等工具改代码（软引导，非强制拦截）。
工具
| 工具 | 说明 |
|---|---|
worker_run(prompt, cwd, timeout=600) |
在 cwd 开启新 worker 会话执行任务，返回结果和 session_id |
worker_continue(prompt, cwd, session_id?, timeout=600) |
对既有会话追加指令；不传 session_id 时续接 cwd 最近一次会话 |
安装
项目内已用 uv 管理独立 Python 3.12（不依赖系统 Python）：
# 如需从零重建环境：
curl -LsSf https://astral.sh/uv/install.sh | env UV_INSTALL_DIR="$PWD/.tools" INSTALLER_NO_MODIFY_PATH=1 sh
UV_PYTHON_INSTALL_DIR="$PWD/.tools/python" .tools/uv venv --python 3.12 .venv
.tools/uv pip install --python .venv/bin/python "mcp>=1.0"
注册到 Claude Code
claude mcp add worker -- /Users/quinlanhoo/Code/KIMI-MCP/KIMI-MCP/.venv/bin/python /Users/quinlanhoo/Code/KIMI-MCP/KIMI-MCP/server.py
之后在 Claude Code 中即可通过 worker_run / worker_continue 工具把任务交给 worker。
配置
| 环境变量 | 默认 | 说明 |
|---|---|---|
WORKER_CLI_BIN |
kimi |
worker CLI 路径（须兼容上述 CLI 契约） |
WORKER_TIMEOUT |
600 |
默认超时秒数（工具参数可单独覆盖） |
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Neon Database
MCP server for interacting with Neon Management API and databases
E2B
Using MCP to run code via e2b.
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.