coding-tools-mcp

环境要求

• Python ≥ 3.11（PyPI 上发布的 Python 服务端）
• 已安装 uvx（Python 工具链）或 npx（Node 工具链，npm 包只是启动器）
• 一个支持 MCP 的客户端：Claude Desktop、Claude Code、Codex、Cursor、Cline、VS Code、Windsurf、Gem
• 一个准备交给 Agent 操作的本地代码仓库目录（绝对路径）

安装与启动步骤

1. 1检查 Python 版本

   服务端要求 Python ≥ 3.11。若改走 Node 工具链用 npx 启动，可跳过这步。

   python --version

   复制

2. 2用 uvx 启动服务

   把 /path/to/repo 换成你自己的仓库绝对路径，--stdio 表示用标准输入输出与客户端通信。

   uvx coding-tools-mcp --stdio --workspace /path/to/repo

   复制

3. 3或改用 Node 工具链

   npm 包是薄启动器，会通过 uv 或 pipx 拉起同一套 Python 服务，两种方式二选一。

   npx coding-tools-mcp --stdio --workspace /path/to/repo

   复制

4. 4写入客户端配置

   把这段 JSON 加到 MCP 客户端的配置里，客户端不同但 JSON 结构一致，Node 用户把 uvx 换成 npx。

   {
     "mcpServers": {
       "coding-tools": {
         "command": "uvx",
         "args": ["coding-tools-mcp", "--stdio", "--workspace", "/path/to/repo"]
       }
     }
   }

   复制

5. 5改用 HTTP 传输

   去掉 --stdio 后服务改用 Streamable HTTP，默认地址 http://127.0.0.1:8765/mcp，两种传输都无会话。

   uvx coding-tools-mcp --workspace /path/to/repo

   复制

6. 6让 Agent 跑起来

   在客户端里确认已连上 coding-tools，然后让它执行测试并修复第一个失败，验证工具链真正可用。

关键配置

如何确认成功

客户端配置后能列出 coding-tools 提供的 18 个工具，并向它提问「run the test suite and fix the first failure」能正常执行；HTTP 模式可访问 http://127.0.0.1:8

常见问题

注意事项

• workspace 必须使用绝对路径，README 明确说明 .. 穿越与符号链接逃逸会被拒绝。
• 服务默认暴露 18 个工具，全部限制在同一个 workspace 内，并受权限模式约束。
• MCP 协议同时兼容 2026-07-28 与 2025-11-25（含 2025-06-18 兼容），只对外声明 tools 能力。
• 逐客户端配置步骤与排错见 docs/quickstart.md 和 docs/mcp-client-config.md。