STARWARCLOUD STARWAR.AI
返回市场
克劳德代码MCP服务器

克劳德代码MCP服务器

作者：KunihiroS33 星标更新：2025-09-11
安装使用来源：spider==github.com

项目介绍

claude-code-mcp 项目

[0.1.6] - 2025-09-11

安全更新

  • 更新 @anthropic-ai/claude-code 版本。

概述

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 实现，通过标准 I/O 接收来自客户端的 JSON 格式请求。内部采用 Base64 编码来平滑处理自然语言文本中的特殊字符（如换行符、引号等），从而提高了稳定性和灵活性。其主要角色是接收请求、编码输入、生成并执行命令，以及以 JSON 格式返回执行结果。 此项目已在 Claude Code CLI 环境中确认可以工作（例如 Ubuntu/WSL2）。

<a href="https://glama.ai/mcp/servers/@KunihiroS/claude-code-mcp"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=1764938764,1187407829&fm=3081&app=3081&f=PNG?w=760&h=200" alt="claude-code-mcp MCP 服务器" /> </a>

💡 能力较弱的 LLM 的 MCP 主机，可以通过 claude-code-mcp 来利用 Claude 的强大功能💪！ 使用 claude-code-mcp，您还可以从 Claude Desktop 调用 Claude Code!! 😇😜😎 （未确认）

功能

服务器的主要角色包括：

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

快速开始

预备条件

安装与使用

有几种方式可以使用 claude-code-mcp：

1. 使用 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 或 ~/.claude-code-mcp.env
CLAUDE_BIN=/path/to/your/claude/executable  # 必需：设置完整的 Claude CLI 路径
LOG_LEVEL=info                             # 可选：设置日志级别（例如，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", // 必需：设置绝对路径
        "LOG_LEVEL": "info"                             // 可选：设置日志级别
      },
      "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 许可证发布 - 详情如下。

MIT 许可证

版权所有 (c) 2024 KunihiroS

在此授权任何人免费获得本软件及其相关文档文件（以下简称“软件”）的副本，
不受限制地使用、复制、修改、合并、出版、分发、再许可和/或销售
软件的副本，并允许向其提供软件的人这样做，但须遵守以下条件：

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

软件按“原样”提供，不附带任何形式的保证，无论是明示的还是默示的，
包括但不限于适销性、特定用途适用性和非侵权性的保证。
在任何情况下，作者或版权持有者均不对因合同、侵权或其他原因引起的任何索赔、损害或其他责任负责，
与软件的使用或其它交易有关。

免责声明

本软件仅供教育和研究目的使用。此项目并未得到 Anthropic 的正式关联或认可。Claude 是 Anthropic 的商标。

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

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