Claude代码工具

你是否曾经希望在自己的MCP客户端中使用Claude Code强大的软件工程能力，包括代码生成与编辑、审查与分析、调试与故障排除？今天要介绍的开源项目Claude代码工具，正是为了实现这个目标而设计的。它将Claude Code实现为MCP服务器，让你可以通过标准化的MCP接口使用Claude Code的各项功能。

项目基本信息

一、项目介绍

Claude代码工具是一个将Claude Code实现为模型上下文协议服务器的项目。Claude Code是Anthropic提供的用于软件工程任务的CLI工具，由Claude支持，提供代码生成和编辑、代码审查和分析、调试和故障排除、文件系统操作、Shell命令执行、项目探索和理解等功能。

通过这个MCP服务器，你可以：

• 在任何兼容MCP的客户端中使用Claude Code的能力
• 执行Shell命令（带有安全限制）
• 读取、编辑和创建文件
• 搜索文件和代码内容
• 进行代码审查和PR审查
• 访问文件系统和环境信息

二、核心优势

功能完整

完全实现了Claude Code的核心功能，包括：

• 文件操作（读取、编辑、搜索）
• Shell命令执行
• 代码审查
• PR审查
• 项目初始化

标准化接口

通过MCP协议提供标准化的工具、资源和提示，与任何MCP客户端兼容。

类型安全

使用TypeScript实现，具有完整的类型定义，开发体验良好。

安全限制

对潜在危险的操作（如curl、wget）实施安全限制，防止执行危险命令。

模块化架构

每个组件（工具、提示、资源）都实现在单独的模块中，易于扩展和维护。

三、适用场景

AI辅助软件开发

让AI助手执行代码生成、编辑、审查、调试等任务，提升开发效率。

代码审查自动化

AI可以自动分析代码中的错误、安全漏洞、性能问题，并提供改进建议。

PR审查

AI可以分析拉取请求的更改，提供全面的反馈。

项目探索

AI可以快速理解陌生项目的结构和代码，帮助新成员上手。

四、安装教程

系统要求

安装步骤

第一步：克隆项目并安装依赖

git clone https://github.com/auchenberg/claude-code-mcp.git
cd claude-code-mcp
npm install
npm run build

第二步：配置MCP客户端

对于Claude Desktop：

找到配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

添加配置：

{
  "mcpServers": {
    "claude-code": {
      "command": "node",
      "args": ["/path/to/claude-code-mcp/dist/index.js"]
    }
  }
}

对于Cursor：

创建或编辑~/.cursor/mcp.json：

{
  "mcpServers": {
    "claude-code": {
      "command": "node",
      "args": ["/path/to/claude-code-mcp/dist/index.js"]
    }
  }
}

第三步：重启客户端

保存配置后，重启Claude Desktop或Cursor。

五、使用示例

配置完成后，你就可以在MCP客户端中使用Claude Code的各种能力了。

示例1：执行Shell命令

用户指令：“列出当前目录下的所有文件”

AI会调用bash工具：

{
  "command": "ls -la"
}

示例2：读取文件

用户指令：“读取src/index.ts文件的内容”

AI会调用readFile工具：

{
  "file_path": "/absolute/path/to/src/index.ts"
}

带行号偏移和限制：

{
  "file_path": "/path/to/file.ts",
  "offset": 10,
  "limit": 20
}

示例3：搜索文件

用户指令：“搜索所有.ts文件”

AI会调用searchGlob工具：

{
  "pattern": "**/*.ts",
  "path": "/path/to/project"
}

示例4：代码搜索

用户指令：“在代码中搜索‘TODO’”

AI会调用grep工具：

{
  "pattern": "TODO",
  "path": "/path/to/project",
  "include": "*.{ts,js}"
}

示例5：代码审查

用户指令：“审查src/index.ts文件的代码质量”

AI会调用codeReview工具，分析错误、安全问题和最佳实践。

示例6：编辑文件

用户指令：“在README.md文件末尾添加一行‘## License’”

AI会调用editFile工具：

{
  "file_path": "/path/to/README.md",
  "content": "## License\n\nMIT"
}

示例7：PR审查

用户指令：“审查PR #123的更改”

AI会调用prReview工具，分析PR更改并提供反馈。

示例8：访问资源

获取环境信息：
AI可以访问env://info资源，获取Node.js版本、npm版本、操作系统信息和环境变量。

列出目录：
AI可以访问dir:///path资源，获取目录内容列表。

读取文件：
AI可以访问file:///path/to/file资源，获取文件内容。

示例9：使用提示

初始化代码库：
AI可以使用initCodebase提示，创建CLAUDE.md文件，记录构建、检查、测试命令和代码风格指南。

六、常见问题

问题1：bash工具提示“Command blocked for security reasons”

解决方案：某些危险命令（如curl、wget）被默认阻止。这是安全设计。如需执行，需要修改源码中的安全限制。

问题2：文件路径必须是绝对路径

解决方案：所有文件操作工具都需要绝对路径。可以使用process.cwd()或path.resolve()获取。

问题3：readFile的offset/limit参数

解决方案：offset是行号（从0开始），limit是要读取的行数。适用于读取大文件的部分内容。

问题4：searchGlob的pattern格式

解决方案：使用glob模式，如**/*.ts匹配所有.ts文件，src/**/*.{ts,js}匹配src下所有.ts和.js文件。

问题5：与官方Claude Code的关系

解决方案：该项目是独立的MCP服务器实现，与Anthropic无官方关联。它实现了Claude Code的工具和提示。

七、总结

Claude代码工具是MCP生态中第一个将Claude Code能力标准化的项目。它让任何MCP客户端都能使用Claude Code强大的软件工程能力。

这个项目的最大价值在于：

1. 功能完整：实现了Claude Code的核心功能
2. 标准化接口：通过MCP协议与任何客户端兼容
3. 安全设计：对危险操作实施安全限制
4. 模块化架构：易于扩展和维护
5. 类型安全：完整的TypeScript类型定义

如果你希望在任何MCP客户端中使用Claude Code的能力，Claude代码工具是最佳选择。