claude-code-mcp 项目文档（完整中文翻译）

更新日志

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

项目概述

claude-code-mcp 是一个提供多种代码相关功能的工具，包括解释、审查、修复、编辑、测试和模拟命令等。该工具通过调用 Anthropic 的 Claude CLI 来实现这些功能，并且完全开源社区驱动，不涉及任何商业用途。

功能概述

1. 功能模块

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

2. 实现方式

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

3. 适用场景

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

安装与使用

先决条件

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

使用方法

方式一：通过 npm 包运行

npx claude-code-mcp

方式二：本地开发使用

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

npm install
npm start

配置说明

环境变量

• 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. 在运行时通过命令行参数指定。

工具列表

1. 提供的工具

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

2. 示例

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

注意事项

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

许可证

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

免责声明

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