claude-code-mcp 项目

更新

现在，此 MCP 服务器可以通过 npx 运行，无需本地安装！！

概述

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 Desktop 调用 Claude Code！！ 😇😜😎 (未经证实)

功能

服务器的主要作用是：

• 请求接收： 接收来自客户端的 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 直接运行服务器，无需安装：

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 设置（推荐用于 npx）： 直接在 MCP Host 的设置中配置环境变量（请参阅下面的“MCP Host 配置”）。 这是使用 npx 时最简单的方法。
2. 使用 .env 文件： 在运行 npx @kunihiros/claude-code-mcp 命令的目录中创建一个 .env 文件。
3. 使用全局配置文件： 在您的主目录 (~/.claude-code-mcp.env) 中创建一个 .claude-code-mcp.env 文件。

如果使用文件（.env 或 ~/.claude-code-mcp.env），请添加以下内容，并调整 CLAUDE_BIN 路径：

# .env 或 ~/.claude-code-mcp.env
CLAUDE_BIN=/path/to/your/claude/executable  # 必需：设置 Claude CLI 的完整路径
LOG_LEVEL=info                             # 可选：设置日志级别（例如，debug、info、warn、error）

MCP Host 配置（推荐用于 npx）：

将以下内容添加到您的 MCP Host 应用程序设置（例如，Claude Desktop 设置）。 此方法允许您直接设置环境变量。

    "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-mcp 命令位于系统的 PATH 中，则可以使用：

    "claude-code-server": {
      "command": "claude-code-mcp",
      "disabled": false
    }

在这种情况下，您必须使用 .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.exe
• LOG_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 许可证获得许可 - 有关详细信息，请参见下文。

MIT License

Copyright (c) 2024 KunihiroS

特此授予任何人免费获得本软件及相关文档文件（“软件”）副本的许可，以便处理本软件，不受限制，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利，并允许向其提供本软件的人员这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。

本软件按“原样”提供，不提供任何形式的明示或暗示的保证，包括但不限于适销性、适用于特定目的和不侵权的保证。 在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论是在合同诉讼、侵权诉讼或其他诉讼中，因本软件或本软件的使用或其他交易而引起或与之相关的。

免责声明

本软件仅用于教育和研究目的。 本项目与 Anthropic 没有正式关联，也没有得到 Anthropic 的认可。 Claude 是 Anthropic 的商标。

该项目使用 Claude CLI 作为依赖项，但它是一项独立的、社区驱动的努力。 用户应确保在使用本项目时遵守 Anthropic 的服务条款。

本项目的维护者不对软件的任何滥用或违反任何第三方 API 或服务的服务条款的行为负责。