Claude Code MCP

🚀 claude-code-mcp 项目文档

claude-code-mcp 是一款强大的代码工具，提供代码解释、审查、修复等多种功能。它借助 Anthropic 的 Claude CLI 实现这些功能，并且完全开源，由社区驱动，不涉及商业用途。

🚀 快速开始

先决条件

1. 确保系统已安装 Node.js（推荐版本：LTS）。
2. 配置环境变量 CLAUDE_BIN 指向 Claude CLI 的可执行文件路径。
3. 根据需求，配置日志记录级别。

使用方法

方式一：通过 npm 包运行

npx claude-code-mcp

方式二：本地开发使用

克隆仓库后安装依赖并启动：

npm install
npm start

✨ 主要特性

功能模块

• explain_code：提供对给定代码的详细解释。
• review_code：审查并评估给定的代码质量。
• fix_code：修复代码中的错误或潜在问题。
• edit_code：根据指令编辑代码内容。
• test_code：自动生成代码的测试用例。
• simulate_command：模拟执行给定命令的行为。
• your_own_query：支持自定义查询，结合上下文信息进行分析。

实现方式

该工具基于 Node.js 开发，使用标准输入输出与 Claude CLI 进行交互。用户可以通过配置环境变量指定 Claude CLI 的路径，并选择日志记录的级别（默认为 info）。

适用场景

• 教育和研究用途。
• 提供代码审查、测试生成等辅助功能。
• 支持自定义查询，满足个性化需求。

📦 安装指南

环境变量

• CLAUDE_BIN：指定 Claude CLI 的路径，必填项。
  • 示例：/home/user/.local/bin/claude（Linux）或 C:\Users\User\AppData\Local\bin\claude.exe（Windows）。
• LOG_LEVEL：设置日志记录级别，默认为 info。
  • 可选值：debug, info, warn, error。

配置文件

支持通过以下方式配置：

1. 在项目根目录创建 .env 文件，添加环境变量。
2. 创建全局配置文件 ~/.claude-code-mcp.env。
3. 在运行时通过命令行参数指定。

💻 使用示例

工具列表

• explain_code：对代码进行详细解释。
• review_code：审查代码并提供建议。
• fix_code：修复代码中的错误或问题。
• edit_code：根据指令编辑代码。
• test_code：自动生成测试用例。
• simulate_command：模拟命令执行过程。
• your_own_query：支持自定义查询，结合上下文信息。

示例

# 使用 explain_code 工具
claude-code-mcp --tool explain_code --code "function hello() { console.log('Hello, World!'); }"

📚 详细文档

更新日志

• 现在可以使用 npx 运行 MCP 服务器，无需本地安装。

🔧 技术细节

该工具基于 Node.js 开发，使用标准输入输出与 Claude CLI 进行交互。它通过调用 Anthropic 的 Claude CLI 来实现代码解释、审查、修复等多种功能。用户可以通过配置环境变量指定 Claude CLI 的路径，并选择日志记录的级别（默认为 info）。

📄 许可证

本项目遵循 MIT 许可证，允许用户自由使用、修改和分发代码，但需在保留版权声明的前提下进行。

⚠️ 重要提示

• 日志文件默认将创建在项目根目录下。如果无法创建，则尝试写入用户主目录或 /tmp 目录。
• 暂未实现日志自动切割功能，请手动管理日志文件大小。
• 该工具已在 Linux 系统上进行了充分测试，Windows 平台可能需要额外配置。

💡 使用建议

• 该项目仅为教育和研究用途而开发，请遵守 Anthropic 的服务条款和条件。
• 不对因不当使用或其他任何方式导致的后果负责。