claude-code-mcp 的安装和配置教程

1. 项目基础介绍和主要编程语言

claude-code-mcp 是一个开源项目，它提供了一个MCP（Model Context Protocol）服务器，允许以一键式模式运行 Claude Code，并自动绕过权限限制。这个项目的主要目的是为了解决 Cursor 在处理复杂、多步骤编辑或操作时的困难，使得 Claude 能够成为一个更直接、更强大的编码任务代理。该项目主要使用 JavaScript 编程语言，依赖于 Node.js 环境。

2. 项目使用的关键技术和框架

• Model Context Protocol (MCP): 一种允许大型语言模型与外部工具交互的协议。
• Node.js: 项目的运行环境，提供了非阻塞 I/O 和事件驱动的模型。
• Claude CLI: Claude Code 的命令行界面，用于与 Claude Code 交互。

3. 项目安装和配置的准备工作及详细安装步骤

准备工作

在开始安装之前，请确保您的系统中已经安装以下软件：

• Node.js v20 或更高版本。可以使用 fnm 或 nvm 来安装或管理 Node.js 版本。
• Claude CLI 已安装在本地上，并已接受 --dangerously-skip-permissions 权限。

安装步骤

1. 安装 Node.js

   如果您的系统中没有安装 Node.js，或者版本低于 v20，可以使用以下命令之一来安装：

   # 使用 fnm 安装 Node.js
   curl -fsSL https://fnm.js.org | bash -s install
   
   # 使用 nvm 安装 Node.js
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
   

2. 安装 Claude CLI

   使用以下命令全局安装 Claude CLI：

   npm install -g @anthropic-ai/claude-code
   

3. 接受权限

   在使用 MCP 服务器之前，需要手动运行一次 Claude CLI 并接受权限：

   claude --dangerously-skip-permissions
   

   按照提示操作，接受相关条款。

4. 安装 claude-code-mcp

   使用 npx 来安装 claude-code-mcp：

   npx @steipete/claude-code-mcp@latest
   

   如果您需要指定一个自定义的 Claude CLI 二进制名称，可以通过环境变量进行设置：

   npx @steipete/claude-code-mcp@latest --env CLAUDE_CLI_NAME=claude-custom
   

5. 配置 MCP 客户端

   在安装完服务器之后，您需要配置您的 MCP 客户端（如 Cursor 或其他使用 mcp.json 或 mcp_config.json 的客户端）。

   根据您的操作系统和使用的客户端，找到相应的配置文件：

   • Cursor:

     • macOS: ~/.cursor/mcp.json
     • Windows: %APPDATA%\\Cursor\\mcp.json
     • Linux: ~/.config/cursor/mcp.json

   • Windsurf:

     • macOS: ~/.codeium/windsurf/mcp_config.json
     • Windows: %APPDATA%\\Codeium\\windsurf\\mcp_config.json
     • Linux: ~/.config/.codeium/windsurf/mcp_config.json

   如果配置文件不存在，请创建它，并添加或更新 claude_code 的配置。

通过以上步骤，您可以成功安装和配置 claude-code-mcp 项目。如果遇到任何问题，请查阅项目的 README.md 文件或相关文档以获取更多信息。