Coding Tools MCP v0.2.2：让任意 AI 对话或智能体直接操作你的代码库
一款通过 MCP 协议提供 20 项代码工具的开源服务器，向 Claude Desktop、Claude Code、Cu…
Coding Tools MCP 是一款基于 Model Context Protocol（模型上下文协议）的开源编码运行时，最近更新至 v0.2.2 版本。它向任何兼容 MCP 的客户端暴露一组统一的代码操作工具，让 AI 对话窗口或智能体（agent）能够直接读写、搜索、修改本地代码库并执行命令，而无需依赖某个特定厂商的 IDE 产品。
项目定位
Coding Tools MCP 由 Python（≥ 3.11）实现并发布到 PyPI，npm 包作为轻量启动器调用 uv 或 pipx 启动服务。它提供 20 项工具，按功能分为四类：
- 文件与搜索：read_file、list_dir、list_files、search_text、apply_patch、view_image
- 执行：exec_command、write_stdin、read_output、kill_session、request_permissions
- Git：git_status、git_diff、git_log、git_show、git_blame
- 运行时：server_info、check_exec_environment、get_default_cwd、set_default_cwd
apply_patch 是唯一的文件变更原语，支持阶段性写入、基线校验、跨文件原子提交与回滚。模型可见的工具集保持固定，权限模式只调整命令策略，不会动态改变工具列表——这被项目方称为「真实标注（truthfully annotated）」的固定目录，避免在不同模型或客户端之间切换时出现标注漂移。
客户端兼容与传输方式
默认走 stdio 传输，只需一段 JSON 配置即可接入 Claude Desktop、Claude Code、Cursor、Cline 等主流 MCP 客户端。也可以去掉 --stdio 参数，改用 Streamable HTTP 在 127.0.0.1:8765/mcp 上提供服务，遵循 MCP 2025-11-25 规范并兼容 2025-06-18 版本。结合 Cloudflare Tunnel、ngrok 或 Microsoft Dev Tunnel 等内网穿透工具，可以让 claude.ai 等远程客户端通过 HTTPS 隧道访问本机服务，并通过 Bearer Token 或 OAuth 2.1 + PKCE（含 RFC 7591 动态注册）鉴权。
安全边界
项目把「安全即产品」作为核心卖点。每个服务器实例绑定一个工作区根目录，绝对路径、父目录穿越与符号链接逃逸会被拒绝；递归列出与搜索默认排除 .git、node_modules、构建产物、虚拟环境与缓存目录。命令在工作区内执行，环境变量被清洗，并设有超时与输出上限。
权限模式分三档：safe（默认，文件工具与经过审核的命令可用，涉及网络、Shell 展开、内联脚本与破坏性命令需显式授权）；trusted（本地开发用，开放网络、Shell 展开与内联脚本，仍保留密钥过滤与破坏性命令检查）；dangerous（仅限隔离容器或虚机使用，关闭 exec_command 的权限门控，但工作区路径边界仍然生效）。在 Linux 上还可叠加 Landlock 做内核级文件系统隔离。官方同时提供一个预装工具链与缓存的 Docker 镜像，便于在一次性沙箱中运行不可信 PR。
上下文与可观测性
工具结果会被摘要化、分页并设置硬性上限。项目方表示，在固定 dogfood 工作负载上，确定性的任务完成率不变，而序列化后的工具结果字节数较上一版本下降了约 37%。仓库根目录下的 AGENTS.md 与 CLAUDE.md 会在 initialize 阶段自动加载到上下文。
谁会用它
该项目的目标用户包括：希望把已有的 Claude Desktop 等订阅客户端直接当编码智能体用的个人开发者；在 Anthropic SDK 或自研 agent 循环里不想自己造文件与执行工具、又希望继承完整安全边界的团队；以及需要在隔离沙箱里处理不可信 PR 的开源维护者。v0.2.2 还附带一个英文与简体中文的桌面 GUI（coding-tools-mcp-desktop），用于管理工作区配置、启动/停止服务与隧道、以及凭据配置。