claude-code-mcp Project
2025.03.26
12
JavaScript代码解释代码审查代码修复代码编辑测试生成命令模拟自定义查询开发效率
claude-code-mcp 是一个为 Claude Code 设计的 MCP 服务器，通过 Node.js 和 MCP SDK 实现。它接收来自客户端的 JSON 格式请求，并通过 stdio 进行通信。该服务器的主要功能包括接收请求、编码输入、生成和执行命令，并将执行结果以 JSON 格式返回。它支持多种工具，如代码解释、代码审查、代码修复、代码编辑、测试生成等，适用于开发者在代码开发和调试过程中提高效率。
View on GitHub
Overview
基本能力
产品定位
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（推荐快速使用）
npx @kunihiros/claude-code-mcp
2. 全局安装
npm install -g claude-code-mcp
然后运行：
claude-code-mcp
3. 本地安装（开发用）
git clone https://github.com/KunihiroS/claude-code-mcp.git
cd claude-code-mcp/claude-code-server
npm install
npm run build
运行构建后的脚本：
node build/index.js
调试方式
环境变量配置
创建以下文件之一：
1. 使用 MCP Host 设置：在 MCP Host 的设置中直接配置环境变量。
2. 使用 .env 文件：在运行命令的目录中创建 .env 文件。
3. 使用全局配置文件：在用户主目录中创建 ~/.claude-code-mcp.env 文件。
示例 .env 文件内容：
CLAUDE_BIN=/path/to/your/claude/executable
LOG_LEVEL=info
MCP Host 配置（推荐 npx 使用）
"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 配置（全局安装/本地开发）
"claude-code-server": {
"command": "claude-code-mcp",
"disabled": false
}