项目简介

这个项目提供了一个基于 Model Context Protocol (MCP) 的服务器实现，它作为一个中间层，允许支持 MCP 的客户端（如 Cursor、Windsurf、VS Code 等 IDE）更强大地调用 Claude Code 命令行工具。其核心能力是提供两个工具：一个通用的代码执行工具 ('code') 和一个强大的文件编辑工具 ('magic_file')，并且默认绕过了 Claude CLI 的权限提示，使得自动化任务执行更顺畅。

主要功能点

提供增强工具: 暴露 'code' 和 'magic_file' 两个 MCP 工具，供 LLM 客户端调用。
自动权限绕过: 调用 Claude Code CLI 时自动使用 '--dangerously-skip-permissions' 参数，消除权限交互，实现一键执行。
通用代码执行 ('code'): 可以直接执行任意给定的自然语言提示词，利用 Claude Code 的广泛能力处理复杂的多步骤任务，例如代码生成、分析、重构、执行终端命令、进行 Git 操作等。
智能文件编辑 ('magic_file'): 专注于基于自然语言指令进行文件修改，适用于复杂的语义化编辑或标准编辑工具难以处理的场景。
Stdio 传输支持: 通过标准输入/输出来与 MCP 客户端通信，易于集成到 IDE。

安装步骤

确保您的系统已安装 Node.js (v16 或更高版本)。
确保已安装 Claude CLI 并正常工作。通常可以通过在支持 Claude 的终端中运行 '/doctor' 来安装或更新 Claude CLI 到标准位置（例如 macOS/Linux 下是 '~/.claude/local/claude'），服务器会默认检查这些位置。

克隆仓库到本地目录：

git clone https://github.com/steipete/claude-code-mcp.git
cd claude-code-mcp

安装项目依赖 (这也会安装 'tsx' 用于直接运行 TypeScript)：
```
npm install
```
使启动脚本在 macOS 或 Linux 上可执行：
```
chmod +x start.sh
```
(Windows 用户通常无需此步骤，使用 'start.bat' 启动)

服务器配置

为了让 MCP 客户端（如 Cursor、VS Code Claude 扩展等）能够连接到此服务器，您需要在客户端的 MCP 配置文件中添加服务器的启动信息。

找到您的客户端的 MCP 配置文件。常见的位置包括：

Cursor (macOS): '~/.cursor/mcp.json'
Cursor (Windows): '%APPDATA%\cursor\mcp.json'
Cursor (Linux): '~/.config/cursor/mcp.json'
VS Code Claude Extension: '~/.vscode/extensions/saoudrizwan.claude-dev/settings/cline_mcp_settings.json' (如果文件不存在，请创建它。)

在配置文件中添加或修改 'mcpServers' 部分，加入 'claude_code' 服务器的配置。请将以下示例中的 '/absolute/path/to/your/claude-code-mcp' 替换为您实际克隆项目到的本地路径。

配置示例 (macOS/Linux):

{
  "mcpServers": {
    "claude_code": {
      "type": "stdio", // 使用 stdio 传输协议进行通信
      "command": "/absolute/path/to/your/claude-code-mcp/start.sh", // 指定服务器启动脚本的完整路径
      "args": [] // 启动脚本的参数列表，本服务器通常不需要额外的命令行参数
    }
  }
}

配置示例 (Windows): 请使用 'start.bat' 脚本的路径，并确保路径格式正确（可以使用 '' 或 '/'）。

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

完成配置后，请重启您的客户端 IDE，使其加载新的 MCP 服务器配置并尝试连接。

基本使用方法

一旦服务器在客户端中成功加载，客户端中的 LLM（如通过聊天窗口或 AI 功能）就能够感知到这个新的服务器及其提供的工具。

当您向 LLM 提出与代码生成、文件修改或需要执行 Claude CLI 命令相关的请求时，如果 LLM 判断需要使用外部工具，它就可能自动调用此服务器提供的 'code' 或 'magic_file' 工具来完成任务。

例如，您可以在 IDE 的 AI 聊天界面中说：

"写一个函数来实现斐波那契数列。" (可能会触发 'code' 工具)
"请将当前打开的文件中的所有回调函数转换为 Promise。" (可能会触发 'magic_file' 工具)
"检查我的代码库并修复所有 lint 错误。" (可能会触发 'code' 或 'magic_file' 工具)

具体的工具调用过程由客户端和 LLM 根据您的指令自动完成，您无需手动构造复杂的 JSON 请求。服务器会在后台接收这些请求，调用 Claude CLI 执行，并将结果返回给客户端和 LLM。

关键词

信息