克劳德代码MCP服务器

Name: 克劳德代码MCP服务器
Author: steipete

作者：steipete927 星标更新：2025-05-25

安装使用来源：spider==github.com

项目介绍

Claude Code MCP 服务器

一个允许在单次模式下运行 Claude Code 并自动绕过权限检查的 MCP（模型上下文协议）服务器。

概述

此 MCP 服务器提供了两种工具，LLMs 可以使用这些工具与 Claude Code 进行交互。当与 Claude Desktop 或其他 MCP 客户端集成时，它允许 LLMs：

使用所有权限被绕过的 Claude Code（使用 --dangerously-skip-permissions）
在没有任何权限中断的情况下执行任何提示的 Claude Code
直接访问文件编辑功能
默认启用特定工具

先决条件

Node.js v16 或更高版本
TypeScript（用于开发）
已安装并正常工作的 Claude CLI。确保 Claude CLI 已安装并可访问，最好通过运行 /doctor 来安装或更新 CLI 到 ~/.claude/local/claude，该服务器默认会检查这个路径。

安装

克隆或下载此仓库：

git clone https://github.com/yourusername/claude-mcp-server.git
cd claude-mcp-server

安装依赖项（这也会安装 tsx 以便直接执行 TypeScript）：

npm install

将启动脚本设置为可执行：

chmod +x start.sh

连接到 Cursor/Windsurf/Visual Studio Code

macOS

找到 MCP 配置文件：
```
~/.cursor/mcp.json
```
如果不存在，请创建该文件。
向文件中添加服务器配置：

{
  "mcpServers": {
    "claude_code": {
      "type": "stdio",
      "command": "/absolute/path/to/claude-mcp-server/start.sh",
      "args": []
    }
  }
}

确保将 /absolute/path/to/claude-m_服务器 替换为您实际安装服务器的位置。

Windows

找到 MCP 配置文件：
```
%APPDATA%\cursor\mcp.json
```
如果不存在，请创建该文件。
向文件中添加服务器配置，确保使用 Windows 路径格式：

{
  "mcpServers": {
    "claude_code": {
      "type": "stdio",
      "command": "C:\\path\\to\\claude-mcp-server\\start.bat",
      "args": []
    }
  }
}

对于 Windows，您应该使用批处理文件（start.bat）而不是 shell 脚本。

Linux

找到 MCP 配置文件：
```
~/.config/cursor/mcp.json
```
如果不存在，请创建该文件。
向文件中添加服务器配置：

{
  "mcpServers": {
    "claude_code": {
      "type": "stdio",
      "command": "/absolute/path/to/claude-mcp-server/start.sh",
      "args": []
    }
  }
}

更新配置后，重启您的 IDE 以加载 MCP 服务器。

环境变量

您可以使用以下环境变量自定义服务器行为（在 start.sh 或 start.bat 中编辑它们）：

CLAUDE_CLI_PATH：可选。 设置 Claude CLI 可执行文件的自定义绝对路径。如果已设置且路径指向现有文件，则将直接使用此路径。
MCP_CLAUDE_DEBUG：设置为 true 以启用从服务器到 stderr 的详细调试日志记录（例如，MCP_CLAUDE_DEBUG=true ./start.sh）。

Claude CLI 发现顺序：

由 CLAUDE_CLI_PATH 环境变量指定的路径（如果已设置且有效）。
类 Unix 系统的默认安装路径：~/.claude/local/claude（其中 ~ 是用户的主目录）。对于 Windows 用户，这种自动检查可能不适用；建议依赖 CLAUDE_CLI_PATH 或确保 claude 在系统 PATH 中。
默认为简单的 claude，依赖于系统的 PATH 解析（如果使用了此回退，将会记录警告）。

连接到 VSCode Claude

要在 VSCode 中使用此 MCP 服务器：

在 VSCode 中安装 Claude 扩展

创建或编辑 MCP 设置文件：

~/.vscode/extensions/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

添加服务器配置：

{
  "mcpServers": {
    "claude_code": {
      "command": "/absolute/path/to/claude-mcp-server/start.sh",
      "args": [],
      "disabled": false
    }
  }
}

使用方法

一旦安装并连接到 MCP 客户端，您可以使用以下格式调用工具：

Claude Code 工具（重命名为 `code`）

{
  "tool_name": "code",
  "params": {
    "prompt": "在这里向 Claude Code 发送提示",
    "options": {
      "tools": ["Bash", "Read", "Write"]
    }
  }
}

如果没有指定工具，服务器将默认启用常见工具。

Claude 文件编辑工具（重命名为 `magic_file`）

{
  "tool_name": "magic_file",
  "params": {
    "file_path": "/path/to/your/file.js",
    "instruction": "将 processData 函数重构为使用 async/await 而不是 promise。"
  }
}

工具描述

服务器提供两种工具：

工具名称：code
- 描述："直接使用 Claude Code CLI 执行给定提示，绕过所有权限检查（--dangerously-skip-permissions）。适用于广泛的任务，包括：复杂的代码生成、分析和重构；执行网络搜索并总结内容；运行任意终端命令（例如，open . 打开 Finder，open -a Calculator 打开应用程序，或 open https://example.com 在浏览器中打开 URL）。例如，您可以在所有测试通过后打开 GitHub PR 页面。处理需要 Claude CLI 广泛能力的一般任务，无需交互式提示。options.tools 可用于指定内部 Claude 工具（如 Bash、Read、Write）；如果省略，默认启用常见工具。"
- 参数：
  - prompt（必需）：发送给 Claude Code 的提示
  - options.tools（可选）：要启用的具体工具数组
- 实现：使用 claude --dangerously-skip-permissions（通过 child_process.spawn 调用）来绕过所有权限检查。服务器首先检查 CLAUDE_CLI_PATH 环境变量，然后查找 ~/.claude/local/claude，最后回退到系统 PATH 中的 claude。
工具名称：magic_file
- 描述："根据自然语言指令编辑指定文件，利用 Claude Code CLI 绕过所有编辑权限（--dangerously-skip-permissions）。最适合复杂或语义化的文件修改，其中用普通语言描述所需更改比精确的逐行编辑更有效。需要绝对的 file_path 和描述性的 instruction。也是如果通用的 edit_file 工具难以处理复杂编辑或特定文件类型时的一个好选择。示例指令：'将 processData 函数重构为使用 async/await 而不是 promise。'"
- 参数：
  - file_path（必需）：要编辑的文件的绝对路径
  - instruction（必需）：对文件进行编辑的自由文本描述
- 实现：使用 claude --dangerously-skip-permissions（通过 child_process.spawn 调用）并启用编辑工具。服务器首先检查 CLAUDE_CLI_PATH 环境变量，然后查找 ~/.claude/local/claude，最后回退到系统 PATH 中的 claude。

故障排除

工具未显示：检查 Claude 日志中的错误信息，确保启动 MCP 服务器时没有问题。确保 start.sh 或 start.bat 是可执行的，并且 tsx 已安装并可运行（通常通过 npx）。
命令未找到 / "错误：spawn claude ENOENT" / "[警告] 未找到 Claude CLI... 回退到 PATH 中的 'claude'..."：这意味着服务器无法通过 CLAUDE_CLI_PATH 环境变量（如果已设置）、默认的类 Unix 位置（~/.claude/local/claude），或系统 PATH（如果回退到仅 'claude'）找到 claude 可执行文件。
- 确保正确安装了 Claude CLI。对于类 Unix 系统，通常位于 ~/.claude/local/claude（通过在 Claude 上下文中运行 /doctor 来验证）。对于 Windows，确保它在您的系统 PATH 中或设置 CLAUDE_CLI_PATH。
- 显式地在 start.sh 或 start.bat 中设置 CLAUDE_CLI_PATH 环境变量为您的 claude 可执行文件的正确绝对路径。
权限错误：确保 start.sh 脚本是可执行的，并且 Node.js 有权执行 tsx 和 Claude CLI（无论通过 CLAUDE_CLI_PATH、默认路径还是系统 PATH 查找）。

许可证

MIT

服务器测试完成。