使用说明

项目简介

MCP Claude Code Server 是一个基于 Model Context Protocol (MCP) 实现的后端服务器，旨在为 LLM 客户端（如 Claude Desktop）提供代码相关的上下文信息和功能，使其能够更好地理解和操作代码项目。该服务器实现了类似 Claude Code 的核心能力，例如代码分析、代码修改、命令执行和文件操作等，通过标准化的 MCP 协议与客户端进行通信，为 LLM 应用提供强大的代码处理能力。

主要功能点

代码理解: 能够分析和理解代码库，支持文件访问和模式搜索，帮助 LLM 理解项目结构和代码内容。
代码修改: 允许 LLM 对文件进行有针对性的编辑，并具备权限控制，确保文件操作的安全性。
增强的命令执行: 支持执行 shell 命令和脚本，并改进了错误处理和 shell 支持，允许 LLM 调用外部程序和工具。
文件操作: 提供创建、移动、管理文件的能力，并进行安全控制，使 LLM 能够进行基本的文件系统操作。
代码发现: 帮助 LLM 查找项目中的相关文件和代码模式，提升代码导航和理解效率。

安装步骤

克隆仓库:

git clone https://github.com/SDGLBL/mcp-claude-code.git
cd mcp-claude-code

创建并激活虚拟环境 (推荐):

python -m venv .venv
source .venv/bin/activate   # Linux/macOS
.venv\Scripts\activate      # Windows

安装依赖:
```
pip install -e .
```

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude Desktop），您需要提供服务器的启动命令和参数。以下是配置信息，请添加到您的 Claude Desktop 配置文件中：

{
  "mcpServers": {
    "claude-code": {  // 服务器名称，可以自定义
      "command": "python", // 启动服务器的命令，这里使用 python
      "args": ["-m", "mcp_claude_code.server"] // 启动服务器的参数，指定运行 mcp_claude_code.server 模块
    }
  }
}

Claude Desktop 系统 Prompt 配置:

为了获得最佳使用体验，您需要将仓库中 'doc/system_prompt.md' 文件的内容复制到 Claude Desktop 客户端的系统 Prompt 配置中。并按照提示将 '{{project_path}}' 替换为您的实际项目路径。

基本使用方法

启动 MCP 服务器: 在克隆的仓库目录下，运行以下命令启动服务器：

python -m mcp_claude_code.server

配置 MCP 客户端: 将上面提供的服务器配置信息添加到您的 MCP 客户端配置中（例如 Claude Desktop）。
使用 LLM 客户端与代码项目交互: 现在，您可以使用配置好的 MCP 客户端（如 Claude Desktop）与 LLM 进行交互，利用服务器提供的工具进行代码分析、编辑、命令执行等操作，从而实现 Claude Code 类似的代码处理能力。

注意: 首次使用或进行文件修改、命令执行等操作时，MCP 客户端可能会请求您授权路径访问或操作权限，请根据需要进行授权。

关键词