跳转到主要内容

Coding Tools MCP

Coding Tools MCP 是一个 Model Context Protocol 服务器,把常见编码操作暴露给 MCP 客户端。客户端可以在受控工作区内读取文件、列目录、搜索文本、应用补丁、运行命令、管理长时间运行的进程、查看 Git 状态、请求权限并查看本地图片。 它不是 agent 框架,也不负责规划任务、维护记忆或替客户端做提示词编排。它提供的是可被客户端调用的工具层。

它提供什么

  • 通过 read_filelist_dirlist_filessearch_text 访问工作区文件和文本。
  • 通过 apply_patch 修改代码。
  • 通过 exec_commandwrite_stdinkill_session 运行和管理命令。
  • 通过 git_statusgit_diffgit_loggit_showgit_blame 查看 Git 信息。
  • 通过 server_infocheck_exec_environmentget_default_cwdset_default_cwd 查看和调整运行时状态。
  • 通过 request_permissions 处理受限操作的权限请求。
  • 在启用时通过 view_image 查看本地图片。

运行模型

包安装后提供 coding-tools-mcp 命令。默认以 Streamable HTTP 方式监听:
http://127.0.0.1:8000/mcp
传入 --stdio 后会改为基于 stdin/stdout 的逐行 JSON-RPC。当前实现声明的 MCP 协议版本为 2025-06-18,支持 initializepinglogging/setLeveltools/listtools/call

安全模型

Coding Tools MCP 围绕一个工作区根目录运行。直接文件工具会在该工作区内解析路径,并带有大小、编码和输入校验。exec_command 由单独的权限模式控制:
模式适用场景
safe默认本地开发姿态。阻止网络特征命令、shell 展开、内联脚本和宽泛临时目录写入。
trusted允许常见本地开发流程,同时保留工作区边界和敏感环境过滤。
dangerous关闭命令权限门禁。只应在外层容器或 VM 已经隔离时使用。
还可以用 --tool-profile read-only 降低暴露工具范围,或用 --tool-profile compat-readonly-all 兼容要求只读注解的客户端。

从哪里开始

先看 快速开始 启动服务,再看 安装与配置 选择传输、鉴权和权限模式。接入客户端时看 客户端接入,需要精确工具名称和参数时看 工具参考