Claude Code MCP Bridge Skill 技能

技能简介（38字） 将 Claude Code 封装为可被其他 MCP 客户端调用的一次性（one-shot）MCP Server，使 Cursor、Windsurf、Codex 等 Agent 能够委托复杂编程任务给 Claude Code 执行。

核心能力（6条）

1. 一次性 MCP 委托语义：MCP 客户端调用 unified claude_code 工具，触发 Claude Code 在独立进程中执行完整编程任务（代码生成/审查/重构/测试编写），结果以结构化输出返回给调用方。
2. 多 Agent 框架全面兼容：支持 npx skills（通用 Agent）、Claude Code CLI（-a claude-code）、Cursor（-a cursor）、OpenClaw/clawhub（clawhub install）、Codex（-a codex）等主流 Agent 框架的安装命令，兼容任何遵循 Agent Skills 标准的平台。
3. 安全模式灵活配置：默认以 --dangerously-skip-permissions 启动（保留历史行为），可通过 permissionMode 参数切换为 default/acceptedEdits/auto/dontAsk/plan 等 Claude Code 原生权限模式。
4. Agent-in-Agent 编排架构：解决多智能体协作中「主 Agent 调用子 Agent 执行编程」的需求，无需让主 Agent 直接调用底层 CLI，通过标准化 MCP 接口解耦。
5. 零 SDK 依赖：纯 MCP 协议包装，不引入额外 SDK；Node.js v20+ 即可运行，通过 npx @steipete/claude-code-mcp@latest 实时拉取最新版本。
6. 内置调试与日志：支持 MCP_CLAUDE_DEBUG=true 开启详细日志，CLAUDE_CLI_TIMEOUT_SECONDS 自定义 CLI 执行超时（默认 3600 秒），CLAUDE_CLI_NAME 支持自定义 Claude CLI 二进制路径或绝对路径。

安装与配置（3步） 第一步：npm install -g @anthropic-ai/claude-code 安装 Claude CLI 并登录，然后手动运行一次 claude --dangerously-skip-permissions 接受权限条款（一次性要求）。 第二步：在目标 MCP 客户端的配置中添加 { "command": "npx", "args": ["-y", "@steipete/claude-code-mcp@latest"] }，或通过各平台的包管理器安装。 第三步（如使用自定义 Claude CLI）：设置环境变量 CLAUDE_CLI_NAME 指定二进制名称或绝对路径，支持测试环境 mock 或并行多版本 Claude CLI 场景。

使用步骤（3步） 第一步：配置 MCP 客户端——在 Cursor/Windsurf/Codex 等 MCP 客户端中添加 claude-code-mcp server 条目，配置 npx -y @steipete/claude-code-mcp@latest 为启动命令。 第二步：发送编程任务——通过 MCP 接口调用 unified claude_code 工具，传入自然语言描述的编程需求（如「重构这个 React 组件」「为这个函数编写单元测试」）。 第三步：接收结构化结果——Claude Code 执行完任务后，结果通过 MCP 协议返回给调用方 Agent，包含代码输出与元数据，调用方 Agent 继续其主流程。

适用场景（3个） 多智能体流水线协作：在主 Agent 负责任务规划与协调、子 Agent 负责具体代码生成的架构中，通过 MCP 接口将编程任务委托给 Claude Code，提升复杂代码合成的可靠性。 跨编辑器 Agent 工作流：Cursor/Windsurf 用户希望利用 Claude Code 更强的代码生成能力处理复杂重构或多文件编辑场景，无需切换编辑器即可调用 Claude Code。 AI 辅助 CI/CD 任务：在自动化代码审查或持续集成流程中，通过 MCP 调用 Claude Code 执行一次性代码审查、修复或测试生成任务。

适用人群（88字） 使用 Cursor、Windsurf、Codex 等非 Anthropic 系 AI 编程工具、但希望借助 Claude Code 编程能力的开发者；构建多智能体（multi-agent）系统、需要在 Agent 间编排编程任务的技术架构师；以及需要在自动化 CI/CD 流程中引入 Claude Code 进行代码审查与修复的 DevOps 工程师。

官方链接 GitHub：https://github.com/steipete/claude-code-mcp