MCP Claude Code

MCP Claude Code

使用模型上下文协议（MCP）实现 Claude Code 的功能。

概述

此项目提供了一个 MCP 服务，用于实现类似 Claude Code 的功能，让 Claude 可以直接执行指令，修改和改进项目文件。借助模型上下文协议，此实现可与包括 Claude Desktop 在内的各种 MCP 客户端无缝集成。

功能

• 代码理解：通过访问文件和搜索模式分析并理解代码库
• 代码修改：在正确处理权限的前提下，对文件进行有针对性的编辑
• 增强的命令执行：使用改进的错误处理和 Shell 支持，运行各种语言的命令和脚本
• 文件操作：通过 Shell 命令，在适当的安全控制下管理文件
• 代码发现：通过高性能搜索，在项目中查找相关文件和代码模式
• Agent 委派：将复杂任务委派给可并行工作的专用子 Agent
• 多种大模型提供商支持：为 Agent 操作配置任何兼容 LiteLLM 的模型
• Jupyter Notebook 支持：读取和编辑 Jupyter Notebook，并完整处理单元格和输出

已实现的工具

工具	描述
read	读取文件内容，支持行号、偏移量和限制读取范围
write	创建或覆盖文件
edit	对文本文件进行基于行的编辑
multi_edit	在单个文件操作中执行多项精确的文本替换，并采用原子事务
directory_tree	获取目录的递归树状视图
grep	快速搜索文件中的模式，并集成 ripgrep 以获得最佳性能（文档）
content_replace	替换文件内容中的模式
grep_ast	使用 AST 上下文搜索代码，显示函数、类和其他结构中的匹配项
run_command	执行 shell 命令（也用于创建目录、移动文件和列出目录）
notebook_read	从 Jupyter notebook 的所有单元格中提取并读取源代码及输出
notebook_edit	编辑、插入或删除 Jupyter notebook 中的单元格
think	用于复杂推理和分析的结构化空间，不会进行任何更改
dispatch_agent	启动一个或多个 Agent，使其能够并发使用只读工具执行任务
batch	在单个请求中并行或串行执行多个工具调用
todo_write	创建和管理结构化任务列表
todo_read	读取结构化任务列表

入门

有关详细的安装和配置说明，请参阅 INSTALL.md。

有关 0.3 版本的详细教程，请参阅 TUTORIAL.md

安全

此实现遵循保护文件系统访问安全的最佳实践：

• 修改文件和执行命令前会请求权限
• 仅限访问指定目录
• 验证并清理输入
• 妥善处理和报告错误

开发

如需为此项目做出贡献：

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到该分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

许可证

此项目采用 MIT License 许可，详情请参阅 LICENSE 文件。