claude-code-mcp Project

claude-code-mcp 项目

⚠️ 已停止维护（2026-08-25）

本项目已停止维护。不会再发布任何更新，包括安全修复。 该仓库已归档，npm 包也已标记为弃用。 现有安装仍可继续使用，但风险由您自行承担——此日期之后报告的依赖项漏洞将不会得到修复。

如果您需要同等功能，请 fork 此仓库，或寻找仍在积极维护的替代方案。

---

[0.1.9] - 2026-03-06

安全更新

• 添加 pnpm overrides，将传递依赖固定到已修补的版本。
  • hono ^4.12.4（修复 serveStatic 路径遍历、SSE CRLF 注入、Cookie 属性注入，以及 basicAuth/bearerAuth 计时问题）
  • @hono/node-server >=1.19.10（修复通过编码斜杠绕过授权的问题）
  • ajv >=8.18.0（修复 $data 选项导致的 ReDoS）
  • qs >=6.14.2（修复通过绕过 arrayLimit 导致的 DoS）

[0.1.8] - 2026-02-05

安全更新

• 更新 @modelcontextprotocol/sdk 版本。
• 添加 zod 依赖以满足对等依赖要求。
• 升级 TypeScript 版本，以兼容更新后的依赖项。

概述

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 等）中运行。

💡 能力较弱的大模型也能通过 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 宿主设置（推荐用于 npx）： 在 MCP 宿主的设置中直接配置环境变量（见下文“MCP 宿主配置”）。使用 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 or ~/.claude-code-mcp.env
CLAUDE_BIN=/path/to/your/claude/executable  # REQUIRED: Set the full path to your Claude CLI
LOG_LEVEL=info                             # Optional: Set log level (e.g., debug, info, warn, error)

MCP 宿主配置（推荐用于 npx）：

将以下内容添加到 MCP 宿主应用的设置中（例如 Claude Desktop 设置）。这种方式可以直接设置环境变量。

    "claude-code-server": {
      "command": "npx",
      "args": [
        "-y",
        "@kunihiros/claude-code-mcp"
      ],
      "env": {
        "CLAUDE_BIN": "/path/to/your/claude/executable", // REQUIRED: Set the absolute path
        "LOG_LEVEL": "info"                             // Optional: Set log level
      },
      "disabled": false
    }

（可能需要重启宿主应用。）

替代 MCP 宿主配置（全局安装／本地开发）：

如果你全局安装了软件包，或者在克隆的仓库中本地运行，并且 claude-code-mcp 命令位于系统的 PATH 中，可以使用：

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

在这种情况下，必须按照上述说明，使用 .env 文件或全局 ~/.claude-code-mcp.env 文件配置环境变量。

环境变量详情

此服务使用以下环境变量（通过 MCP 宿主 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 License 授权，详情见下文。

MIT License

Copyright (c) 2024 KunihiroS

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

免责声明

本软件仅用于教育和研究目的。本项目与 Anthropic 没有官方关联，也未获得其认可。Claude 是 Anthropic 的商标。

本项目将 Claude CLI 用作依赖项，但本身是独立的社区驱动项目。使用本项目时，用户应确保遵守 Anthropic 的服务条款。

本项目的维护者不对软件的任何误用，或违反任何第三方 API 或服务的服务条款承担责任。