Claude Code MCP 服务器开源项目教程-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00197/article/details/148296893

Claude Code MCP 服务器开源项目教程

claude-code-mcp Claude Code as one-shot MCP server 项目地址: https://gitcode.com/gh_mirrors/claud/claude-code-mcp

1. 项目介绍

Claude Code MCP 服务器是一个开源项目，它提供了一个MCP（Model Context Protocol）服务器，允许以一击模式运行Claude Code，并自动绕过权限限制。此服务器特别适用于想要在编码任务中利用Claude Code能力的开发者，它为大型语言模型（LLM）与Claude Code之间的交互提供了便利。

2. 项目快速启动

首先，确保你的系统满足以下先决条件：

Node.js版本20或更新（使用fnm或nvm安装）
本地安装了Claude CLI（运行它并调用 /doctor 命令），并接受 --dangerously-skip-permissions 权限。

安装

推荐使用 npx 安装此服务器：

npx @steipete/claude-code-mcp@latest

如果要使用自定义的Claude CLI二进制名称，可以在环境变量中指定：

{
  "claude-code-mcp": {
    "command": "npx",
    "args": ["-y", "@steipete/claude-code-mcp@latest"],
    "env": {
      "CLAUDE_CLI_NAME": "claude-custom"
    }
  }
}

首次设置：接受权限

在MCP服务器能够使用 claude_code 工具之前，需要手动运行一次Claude CLI，并带上 --dangerously-skip-permissions 标志，登录并接受条款。这是一个一次性要求。

npm install -g @anthropic-ai/claude-code
claude --dangerously-skip-permissions

按照提示操作以接受权限。完成后，MCP服务器将能够非交互式地使用该标志。

3. 应用案例和最佳实践

配置MCP客户端

设置好服务器后，需要配置你的MCP客户端（例如Cursor或其他使用 mcp.json 或 mcp_config.json 的客户端）。

根据你使用的客户端，配置文件的位置可能有所不同：

Cursor 使用 mcp.json，路径如下：
- macOS: ~/.cursor/mcp.json
- Windows: %APPDATA%\\Cursor\\mcp.json
- Linux: ~/.config/cursor/mcp.json
Windsurf 用户使用 mcp_config.json，路径如下：
- macOS: ~/.codeium/windsurf/mcp_config.json
- Windows: %APPDATA%\\Codeium\\windsurf\\mcp_config.json
- Linux: ~/.config/.codeium/windsurf/mcp_config.json

创建或更新该文件，配置 claude_code 工具：

{
  "tools": {
    "claude_code": {
      "uses": "steipete/claude-code-mcp"
    }
  }
}

使用案例

以下是一个使用 claude_code 工具的简单示例：

const { claude_code } = require('claude-code-mcp');

async function runClaudeCode(prompt) {
  const response = await claude_code.run(prompt);
  console.log(response);
}

runClaudeCode('请提供一段代码示例...');