Claude Code MCP 服务器

<img src="assets/claude_code_mcp_logo.png" alt="Claude Code MCP 徽标">

这是一个 MCP（模型上下文协议）服务器，允许以一次性模式运行 Claude Code，并自动绕过权限。

你是否注意到 Cursor 在处理复杂的多步骤编辑或操作时有时会遇到困难？这个服务器通过其强大的统一 claude_code 工具，旨在使 Claude 成为你的编码任务中更直接和有能力的代理。

<img src="assets/screenshot.png" width="300" alt="屏幕截图">

概述

此 MCP 服务器提供了一个工具，可以被 LLMs 用来与 Claude Code 交互。当与 Claude Desktop 或其他 MCP 客户端集成时，它允许 LLMs：

• 使用 --dangerously-skip-permissions 绕过所有权限运行 Claude Code
• 执行任何提示的 Claude Code 而不会受到权限中断
• 直接访问文件编辑功能
• 默认启用特定工具

优点

• Claude/Windsurf 经常在编辑文件时遇到困难。Claude Code 更好更快。
• 可以将多个命令排队而不是直接执行。这节省了上下文空间，因此更多重要信息可以保留更长时间，减少压缩次数。
• 文件操作、git 或其他操作不需要昂贵的模型。如果你注册了 Antropic Max，Claude Code 是非常经济的。你可以使用 Gemini 或 o3 的 Max 模式，并通过将任务卸载到更便宜的模型上来节省成本。
• Claude 具有更广泛的系统访问权限，可以做 Cursor/Windsurf 不能做（或认为不能做）的事情，所以每当它们卡住时，只需告诉它们“使用 Claude Code”，通常就能解决问题。
• 代理中的代理规则。

<img src="assets/agents_in_agents_meme.jpg" alt="代理中的代理梗图">

前提条件

• Node.js v20 或更高版本（使用 fnm 或 nvm 安装）
• 本地安装了 Claude CLI（运行并调用 /doctor），并且接受 -dangerously-skip-permissions。

配置

环境变量

• CLAUDE_CLI_NAME：覆盖 Claude CLI 二进制文件名或提供绝对路径（默认值：claude）。这允许你使用自定义的 Claude CLI 二进制文件。这对于以下情况很有用：

  • 使用自定义 Claude CLI 封装
  • 测试模拟二进制文件
  • 并行运行多个 Claude CLI 版本

  支持的格式：

  • 简单名称：CLAUDE_CLI_NAME=claude-custom 或 CLAUDE_CLI_NAME=claude-v2
  • 绝对路径：CLAUDE_CLI_NAME=/path/to/custom/claude

  不允许相对路径（例如，./claude 或 ../claude），否则会抛出错误。

  当设置为简单名称时，服务器将在以下位置查找指定的二进制文件：

  1. 系统 PATH（而不是默认的 claude 命令）

  注意：本地用户安装路径（~/.claude/local/claude）仍将被检查，但仅用于默认的 claude 二进制文件。

• MCP_CLAUDE_DEBUG：启用调试日志（设置为 true 以输出详细信息）

安装与使用

推荐使用 npx 来安装和使用此服务器。

json "claude-code-mcp": { "command": "npx", "args": [ "-y", "@steipete/claude-code-mcp@latest" ] },

要使用自定义的 Claude CLI 二进制文件名，可以指定环境变量：

json "claude-code-mcp": { "command": "npx", "args": [ "-y", "@steipete/claude-code-mcp@latest" ], "env": { "CLAUDE_CLI_NAME": "claude-custom" } },

重要的一次性设置：接受权限

在 MCP 服务器能够成功使用 claude_code 工具之前，你必须先手动运行一次带有 --dangerously-skip-permissions 标志的 Claude CLI，登录并接受条款。

这是 Claude CLI 的一次性要求。

bash npm install -g @anthropic-ai/claude-code

bash claude --dangerously-skip-permissions按照提示接受。完成此步骤后，MCP 服务器将能够非交互地使用该标志。

macOS 可能在工具首次运行时请求各种文件夹权限，导致首次运行失败。后续运行将会正常工作。

连接到您的 MCP 客户端

在设置好服务器之后，您需要配置您的 MCP 客户端（如 Cursor 或其他使用 mcp.json 或 mcp_config.json 的客户端）。

MCP 配置文件

配置通常在一个 JSON 文件中完成。根据您的客户端不同，文件名和位置可能会有所不同。

Cursor

Cursor 使用 mcp.json。

• macOS: ~/.cursor/mcp.json
• Windows: %APPDATA%\Cursor\mcp.json
• Linux: ~/.config/cursor/mcp.json

Windsurf

Windsurf 用户使用 mcp_config.json

• macOS: ~/.codeium/windsurf/mcp_config.json
• Windows: %APPDATA%\Codeium\windsurf\mcp_config.json
• Linux: ~/.config/.codeium/windsurf/mcp_config.json

（注意：在某些混合设置中，如果也安装了 Cursor，这些客户端可能会回退到使用 Cursor 的 ~/.cursor/mcp.json 路径。如果使用 Codeium 扩展，请优先考虑 Codeium 特定的路径。）

如果该文件不存在，请创建它。添加或更新 claude_code 的配置：

提供的工具

此服务器提供一个主要工具：

claude_code

直接使用带有 --dangerously-skip-permissions 参数的 Claude Code CLI 执行提示。

参数:

• prompt (字符串, 必需): 发送到 Claude Code 的提示。
• options (对象, 可选):
  • tools (字符串数组, 可选): 启用特定的 Claude 工具（例如，Bash, Read, Write）。默认情况下启用常用工具。

示例 MCP 请求: json { "toolName": "claude_code:claude_code", "arguments": { "prompt": "将 main.py 中的函数 foo 重构为异步函数。" } }

示例

以下是一些服务器实际操作的视觉示例：

<img src="assets/claude_tool_git_example.png" alt="Claude Tool Git Example" width="50%"> <img src="assets/additional_claude_screenshot.png" alt="Additional Claude Screenshot" width="50%"> <img src="assets/cursor-screenshot.png" alt="Cursor Screenshot" width="50%">

修复 ESLint 设置

这是一个使用 Claude Code MCP 工具交互式修复 ESLint 设置的示例，通过删除旧配置文件并创建新文件来实现：

<img src="assets/eslint_example.png" alt="ESLint file operations example" width="50%">

列出文件示例

这是 Claude Code 工具列出目录中文件的示例：

<img src="assets/file_list_example.png" alt="File listing example" width="50%">

主要使用场景

通过其统一的 claude_code 工具，此服务器解锁了一系列强大的功能，使您的 AI 直接访问 Claude Code CLI。以下是一些您可以实现的例子：

1. 代码生成、分析与重构:

   • "生成一个解析 CSV 数据并输出 JSON 的 Python 脚本。"
   • "分析 my_script.py 潜在的错误并提出改进建议。"

2. 文件系统操作（创建、读取、编辑、管理）:

   • 创建文件: `"您的工作文件夹是 /Users/steipete/my_project

在 app/settings 目录下创建一个名为 config.yml 的新文件，内容如下： port: 8080 database: main_db" - **编辑文件:**"您的工作文件夹是 /Users/steipete/my_project

编辑 public/css/style.css 文件：在末尾添加一个新的 CSS 规则，使所有 h2 元素的颜色为 navy。" - **移动/复制/删除:**"您的工作文件夹是 /Users/steipete/my_project

将 drafts 文件夹中的 report.docx 文件移动到 final_reports 文件夹，并将其重命名为 Q1_Report_Final.docx。"`

1. 版本控制（Git）:

   • `"您的工作文件夹是 /Users/steipete/my_project

2. 将 src/main.java 文件暂存。

3. 提交更改，消息为 feat: 实现用户认证。

4. 将提交推送到 origin 的 develop 分支。"`### 运行终端命令

• `"你的工作目录是 /Users/steipete/my_project/frontend

运行命令 npm run build 。"`

• "在我的默认浏览器中打开 URL https://developer.mozilla.org 。"

网络搜索与总结

• "搜索网络上的 服务器端渲染的好处 并提供一个简洁的总结。"

复杂的多步骤工作流

• 自动化版本更新、更新变更日志并标记发布：`"你的工作目录是 /Users/steipete/my_project

按照以下步骤操作：1. 将 package.json 中的版本更新为 2.5.0。2. 在 CHANGELOG.md 中为版本 2.5.0 添加一个新的部分，标题为 ### Added ，并列出 新功能 X 。3. 暂存 package.json 和 CHANGELOG.md。4. 使用消息 release: version 2.5.0 提交更改。5. 推送提交。6. 创建并推送 git 标签 v2.5.0。"`

<img src="assets/multistep_example.png" alt="复杂多步骤操作示例" width="50%">

修复带有语法错误的文件

• `"你的工作目录是 /path/to/project

src/utils/parser.js 文件在最近的一次复杂编辑后出现了语法错误，导致其结构被破坏。请分析该文件，识别语法错误，并修正文件使其再次成为有效的 JavaScript，同时尽可能保留原始逻辑。"`

与 GitHub 交互（例如，创建拉取请求）

• `"你的工作目录是 /Users/steipete/my_project

在仓库 owner/repo 中从 feature-branch 分支向 main 分支创建一个 GitHub 拉取请求。标题：feat: 实现新的登录流程。正文：此 PR 为用户添加了一个新的改进版登录体验。"`

与 GitHub 交互（例如，检查 PR 的 CI 状态）

• `"你的工作目录是 /Users/steipete/my_project

检查 GitHub 仓库 owner/repo 中 Pull Request #42 的 C…