代码工具 MCP 服务器
一个模型上下文协议(MCP)服务器,提供与Claude Code内部使用的相同强大的代码操作工具。这使得任何AI代理都能具备同等水平的代码搜索、阅读、编辑和文件操作能力。
特点
该服务器提供了17个核心工具,这些工具的功能与Claude Code相呼应:
- grep(在中文语境中,通常直接使用英文原词,意为“文本搜索工具”或“在文本中搜索”) - 使用 ripgrep 进行快速的基于正则表达式的代码搜索
- glob(通常指一种通配符或模式匹配功能) - 文件模式匹配,支持
**/*.ext模式;图案;样式 - 阅读 - 读取带有行号的文件,并可选择性地指定范围
- 编辑 - 在文件中执行精确的字符串替换
- 写 - 创建或覆盖文件
- git_status(在中文语境中,可直接保留原名,或根据上下文翻译为“Git状态”) - 以瓷盘格式显示工作树的更改
- git_log(在中文语境中,通常直接使用英文原词,不翻译,但若要解释其含义,可译为“Git日志”) - 查询提交历史并应用过滤选项
- git_diff(在中文语境中,可直接译为“Git差异”或“Git差异查看”,但通常根据上下文简化为“Git差异”即可,因为“查看”动作在很多情况下是隐含的) - 比较修订版本、已暂存的更改或特定路径
- git_show(在中文语境中,这个命令名通常保持原样,因为它是特定于Git的命令,但可以解释为“显示Git信息”或“展示Git内容”) - 显示提交详情或对象内容
- git_branch(Git 分支) - 列出带有过滤器和排序的分支
- list_dir(在编程或命令行语境中,通常表示“列出目录”或“列出文件夹内容”的意思,但直接翻译为中文时,可保持为“list_dir”或根据上下文翻译为“列出目录”) - 列出目录内容
- 删除 - 删除单个文件
- 移除 - 删除文件或目录(支持递归删除)
- 复制 - 复制文件或目录
- 移动 - 移动或重命名文件和目录
- 树 - 以ASCII形式可视化目录结构
- 跑 - 执行shell命令并捕获输出
安装
先决条件
- Go 1.21或更高版本
- ripgrep(注:这是一个专有名词,通常不直接翻译,保持原样使用,指的是一个快速的、递归的、正则表达式支持的文本搜索工具) 已安装并可在PATH中使用
建筑
make build配置
创建一个 config.json 文件:
{
"logging": {
"level": "INFO",
"output_file": "code-tools-mcp.log",
"max_size_mb": 10,
"console": true
}
}配置选项
- 日志级别日志级别(DEBUG,INFO,WARN,ERROR)
- 日志输出文件日志文件的路径
- 日志最大大小(以MB为单位)日志文件在轮转前的最大大小(以MB为单位)
- 日志控制台是否也要将日志记录到控制台
使用方法
使用 Claude Desktop
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"code-tools": {
"command": "/path/to/code-tools-mcp",
"args": ["stdio", "--config", "/path/to/config.json"]
}
}
}