claude-code-mcp 项目
更新
现在，此 MCP 服务器无需通过 npx 本地安装即可运行！！
Related MCP server: Fused MCP Agents
概述
claude-code-mcp 项目是 Claude Code 的 MCP 服务器。
它调用本地安装的 Claude Code 命令，并提供以下工具： explain_code 、 review_code 、 fix_code 、 edit_code 、 test_code 、 simulate_command和your_own_query 。服务器使用 Node.js 和 MCP SDK 实现，通过 stdio 接收客户端的 JSON 格式请求。内部采用 Base64 编码，平滑处理自然语言文本中的特殊字符（换行符、引号等），从而提高稳定性和灵活性。其主要作用是接收请求、编码输入、生成并执行命令以及以 JSON 格式返回执行结果。该项目已确认可在 Claude Code CLI 环境（Ubuntu/WSL2 等）上运行。
💡 即使 LLM 能力稍逊，MCP Host 也能驾驭并利用 Claude 的力量💪！有了 claude-code-mcp，你还能从 Claude 桌面调用 Claude 代码！😇😜😎（未经证实）
功能
服务器的主要作用是：
**请求接收：**接收来自客户端的 JSON 格式的工具请求（例如
code、context、focus_areas等）。**输入处理：**内部对接收到的自然语言文本进行 Base64 编码。
**工具选择和命令生成：**根据请求中的工具名称，使用固定模板或自由格式（
your_own_query）为查询组装命令字符串。**命令执行：**使用 Node.js 的
child_process.spawn执行组装的命令并从标准输出获取结果。**结果返回：**将执行结果以JSON格式返回给客户端。
入门
先决条件
Node.js（建议使用 v18 以上版本，已使用 v22.14.0 测试）
npm（或 yarn）
Claude Code 命令已安装且授权已完成。https ://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview
安装与使用
有几种使用claude-code-mcp方法：
1. 使用 npx（推荐快速使用）
您可以使用npx直接运行服务器而无需安装：
2.全局安装
全局安装包：
然后，您可以将其作为命令运行：
3. 本地安装（用于开发）
克隆存储库并安装依赖项：
然后您可以直接运行构建的脚本：
配置
环境变量：
无论采用哪种安装方式，都需要配置环境变量。创建以下文件之一：
**使用 MCP 主机设置（推荐用于
npx）：**直接在 MCP 主机的设置中配置环境变量（请参阅下文的“MCP 主机配置”）。这是使用npx时最简单的方法。**使用
.env文件：**在运行npx @kunihiros/claude-code-mcp命令的目录中创建一个.env文件。**使用全局配置文件：**在您的主目录（
~/.claude-code-mcp.env）中创建一个.claude-code-mcp.env文件。
如果使用文件（ .env或~/.claude-code-mcp.env ），请添加以下内容，调整CLAUDE_BIN路径：
MCP 主机配置（推荐用于
将以下内容添加到您的 MCP Host 应用程序设置（例如，Claude Desktop 设置）。此方法允许您直接设置环境变量。
（可能需要重新启动主机应用程序。）
备选 MCP 主机配置（全局安装 / 本地开发）：
如果您全局安装了该包或从克隆的存储库本地运行它，并且claude-code-mcp命令位于系统的 PATH 中，则可以使用：
在这种情况下，您必须使用.env文件或全局~/.claude-code-mcp.env文件配置环境变量，如上所述。
环境变量详细信息
该服务器使用以下环境变量（通过 MCP Host env设置、 .env或~/.claude-code-mcp.env设置）：
CLAUDE_BIN：指定 Claude CLI 可执行文件的路径。 **（必需）**例如：/home/linuxbrew/.linuxbrew/bin/claude或C:\Users\YourUser\AppData\Local\bin\claude.exeLOG_LEVEL：指定日志级别。（可选，默认为info）。可能的值：debug、info、warn、error。
可用工具
claude-code-mcp服务器提供以下工具：
explain_code：提供给定代码的详细解释。review_code：审查给定的代码。fix_code：修复给定代码中的错误或问题。edit_code：根据指令编辑给定的代码。test_code：为给定的代码生成测试。simulate_command：模拟给定命令的执行。your_own_query：发送带有上下文的自定义查询。
笔记
日志文件（
claude-code-mcp.log）位置：首先尝试在项目根目录中创建。
回退到用户的主目录（
~/.claude-code-mcp.log）。最后回到
/tmp/claude-code-mcp.log。
日志轮换尚未实现（注意日志文件的大小）。
主要在 Ubuntu/WSL2 上使用 Claude CLI 进行测试。
执照
该项目根据 MIT 许可证获得许可 - 详情请见下文。
免责声明
本软件仅供教育和研究之用。本项目与 Anthropic 无正式关联，亦未获得其认可。Claude 是 Anthropic 的商标。
该项目依赖 Claude CLI，但其本身是一个独立的、由社区驱动的项目。用户在使用本项目时应确保遵守 Anthropic 的服务条款。
本项目的维护者对任何软件的误用或任何第三方 API 或服务的服务条款的违反不承担任何责任。