xyTom/coding-tools-mcp

解决的问题

Coding Tools MCP 提供了一个安全的、模型中立的运行时环境，供 AI 智能体与本地代码库进行交互。它免除了每个 AI 聊天客户端或智能体框架实现各自文件系统和 Shell 访问工具的需要，提供了一套标准化的、经过实战检验的 18 种工具，用于在受限的工作区内读取、修补和执行命令。

工作原理

该项目实现了模型上下文协议（MCP），使其能够作为一台服务器，供任何兼容 MCP 的客户端（如 Claude Desktop、Cursor 或 VS Code）驱动。它作为绑定到工作区的运行时运行，将 AI 智能体限制在特定目录中，防止未经授权的文件访问或目录遍历。它支持 stdio 和 HTTP 传输，并包含权限模式（safe、trusted 和 dangerous），用于控制网络访问、Shell 扩展和破坏性命令。

适用人群

• AI 智能体开发者：正在构建自定义智能体循环，希望获得生产级、安全的文件和执行工具，而无需自己动手编写。
• AI 聊天用户：使用 Claude Desktop 或 Gemini CLI 等工具的用户，希望通过直接访问代码库，将其聊天界面转变为编程智能体。
• 注重安全的开发者：需要在不受信任的代码上运行 AI 智能体的开发者，可使用提供的 Docker 沙箱或 Linux 上内核级的 Landlock 限制。

核心亮点

• 模型中立：适用于任何 LLM 或 MCP 客户端，与供应商无关。
• 安全至上：具备工作区限制、权限模式，以及 Linux 上的 Landlock 内核级文件系统限制。
• 全面的工具集：包含用于文件读取/搜索、结构化多文件修补、Git 操作和交互式命令会话（REPL/调试器）的工具。
• 上下文窗口优化：对结果进行摘要和分页，以减少 Token 使用量和序列化的工具结果字节数。
• 灵活的部署方式：可通过 uvx 或 npx 在本地运行，通过经过身份验证的 HTTPS 隧道作为远程服务器运行，或在一次性的 Docker 沙箱中运行。