基本能力
产品定位
claude-code-mcp 是一个为 Claude Code 设计的 MCP 服务器，旨在通过提供多种代码相关工具来提升开发效率。
核心功能
- 请求接收：接收 JSON 格式的工具请求（如
code,context,focus_areas等）。 - 输入处理：使用 Base64 编码处理接收的自然语言文本。
- 工具选择与命令生成：根据请求中的工具名称，使用固定模板或自由格式（
your_own_query）组装查询命令字符串。 - 命令执行：使用 Node.js 的
child_process.spawn执行组装的命令并获取标准输出结果。 - 结果返回：将执行结果以 JSON 格式返回给客户端。
适用场景
- 代码开发和调试过程中需要快速解释、审查、修复或编辑代码的场景。
- 需要生成测试代码或模拟命令执行的场景。
- 开发者希望通过自定义查询与 Claude Code 交互的场景。
工具列表
explain_code：提供给定代码的详细解释。review_code：审查给定代码。fix_code：修复给定代码中的错误或问题。edit_code：根据指令编辑给定代码。test_code：为给定代码生成测试。simulate_command：模拟给定命令的执行。your_own_query：发送带有上下文的自定义查询。
常见问题解答
- 日志文件位置：项目根目录、用户主目录（
~/.claude-code-mcp.log）或/tmp/claude-code-mcp.log。 - 日志轮转：尚未实现，需注意日志文件大小。
- 测试环境：主要在 Ubuntu/WSL2 上的 Claude CLI 环境中测试。
使用教程
使用依赖
- Node.js（>= v18 推荐，测试使用 v22.14.0）
- npm（或 yarn）
- 已安装并完成认证的 Claude Code 命令
安装教程
1. 使用 npx（推荐快速使用）
bash
npx @kunihiros/claude-code-mcp
2. 全局安装
bash
npm install -g claude-code-mcp
然后运行：
bash
claude-code-mcp
3. 本地安装（开发用）
bash
git clone https://github.com/KunihiroS/claude-code-mcp.git
cd claude-code-mcp/claude-code-server
npm install
npm run build
运行构建后的脚本：
bash
node build/index.js
调试方式
环境变量配置
创建以下文件之一：
1. 使用 MCP Host 设置：在 MCP Host 的设置中直接配置环境变量。
2. 使用 .env 文件：在运行命令的目录中创建 .env 文件。
3. 使用全局配置文件：在用户主目录中创建 ~/.claude-code-mcp.env 文件。
示例 .env 文件内容：
dotenv
CLAUDE_BIN=/path/to/your/claude/executable
LOG_LEVEL=info
MCP Host 配置（推荐 npx 使用）
json
"claude-code-server": {
"command": "npx",
"args": ["-y", "@kunihiros/claude-code-mcp"],
"env": {
"CLAUDE_BIN": "/path/to/your/claude/executable",
"LOG_LEVEL": "info"
},
"disabled": false
}
替代 MCP Host 配置（全局安装/本地开发）
json
"claude-code-server": {
"command": "claude-code-mcp",
"disabled": false
}
