Claude Code MCP

claude代码mcp项目

\[0.1.9\] - 2026-03-06

安全更新

• 添加pnpm覆盖，将可传递依赖项固定到修补版本。

- hono ^4.12.4（修复serveStatic路径遍历、SSE CRLF注入、Cookie属性注入、basicAuth/bearrAuth定时） - @hono/node-server >=1.19.10（修复了通过编码斜线绕过授权的问题） - ajv >=8.18.0（修复了ReDoS $data 选项） - qs >=6.14.2（通过arrayLimit旁路修复DoS）

\[0.1.8\] - 2026-02-05

安全更新

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

概述

克劳德代码mcp项目是克劳德代码的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主机的LLM能力较弱，可以驯服和利用克劳德的力量💪! 使用克劳德代码mcp，您还可以从克劳德桌面调用克劳德代码！！ 😇😜😎 （未经证实）

函数

服务器的主要作用是：

• 请求接收： 从客户端接收JSON格式的工具请求（例如。 code, context, focus_areas等等）。
• 输入处理： 内部Base64对接收到的自然语言文本进行编码。
• 工具选择和命令生成： 根据请求中的工具名称，使用固定模板或自由格式为查询组装命令字符串(your_own_query).
• 命令执行： 使用Node.js child_process.spawn 执行组装好的命令并从标准输出中获取结果。
• 结果返回： 以JSON格式将执行结果返回给客户端。

入门指南

先决条件

• Node.js（建议>=v18，用v22.14.0测试）
• npm（或纱线）
• 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. 使用a .env 文件： 创建一个 .env 运行文件的目录中的文件 npx @kunihiros/claude-code-mcp 命令。
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

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没有正式关联或认可。克劳德是Anthropic的商标。

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

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