一行命令启动 coding-tools-mcp:面向 Claude、Codex、Cursor、VS Code 的 MCP 客户端配置终极指南

【免费下载链接】coding-tools-mcpGive any AI agent the ability to code项目地址https://gitcode.com/gh_mirrors/co/coding-tools-mcp点击查看免费下载想让 Claude Desktop、Codex、Cursor 或 VS Code 里的 AI 真正动手改你的代码coding-tools-mcp就是一个模型中立的编程运行时一条uvx命令启动服务器再把一段通用 JSON 粘进客户端配置AI 就能在你的工作区里安全地读文件、打补丁、跑测试、操作 git。本文是面向新手的 MCP 客户端配置完整指南从零到跑通只需 5 分钟。 coding-tools-mcp 是什么为什么新手也需要简单说coding-tools-mcp 给 AI 装上了一双安全的手文件与搜索read_file、list_files、search_text以及原子化、可回滚的apply_patch/apply_changes命令执行exec_command支持长时运行的交互式进程REPL、调试器Git 工具git_status、git_diff、git_log等AI 改完代码自己就能看变更模型中立换 Claude、换 Codex、换 Cursor配置照旧运行时契约不变。它内置 18 个开箱即用的工具每个服务器进程只绑定一个工作区根目录绝对路径穿越、..、符号链接逃逸一律拒绝——安全是产品本身不是附加项。权限模型细节见 docs/permission-modes.md安全边界设计见 docs/security-boundary.md。 最快安装方法一行命令启动 coding-tools-mcp服务器本体是 PyPI 上的 Python 包npm 上则是轻量启动器。任选一种工具链即可来源scripts/install.sh、packages/npm-launcher/uvx coding-tools-mcp --stdio --workspace /path/to/repo # Python 工具链 npx coding-tools-mcp --stdio --workspace /path/to/repo # Node 工具链只需把--workspace换成你自己的仓库路径。--stdio表示通过标准输入输出与客户端通信这是桌面/编辑器客户端最常用的方式。如果你偏好 HTTP 传输去掉--stdio服务器就会在http://127.0.0.1:8765/mcp上提供 Streamable HTTP 端点。完整启动参数与一键安装脚本说明见 docs/quickstart.md。 一段通用 MCP 客户端配置所有客户端共用这是全文最重要的一段 JSON各客户端略有出入但核心相同{ mcpServers: { coding-tools: { command: uvx, args: [coding-tools-mcp, --stdio, --workspace, /path/to/repo] } } }把/path/to/repo替换为你的仓库绝对路径用 Node 工具链的话把uvx换成npx。下面按客户端逐个说明这段 JSON 放哪里。 分客户端一键接入Claude、Codex、Cursor、VS Code 配置步骤Claude Desktop编辑配置文件claude_desktop_config.jsonmacOS 位于~/Library/Application Support/Claude/Windows 位于%APPDATA%\Claude\粘贴上面的 JSON然后重启 Claude Desktop 即可。CodexCodex 使用 TOML 格式在配置文件中添加[mcp_servers.coding_tools] command uvx args [coding-tools-mcp, --stdio, --workspace, /path/to/repo]Claude Code除了写入与 Claude Desktop 相同的 JSON还有一条命令直接搞定claude mcp add coding-tools -- uvx coding-tools-mcp --stdio --workspace /path/to/repoCursor在 Cursor 的 MCP 设置中粘贴通用 JSONmcpServers格式即可保存后 AI 对话中即可调用工具。VS CodeGitHub CopilotVS Code 从工作区内的.vscode/mcp.json读取服务器注意它的键名是servers且多了type: stdio{ servers: { coding-tools: { type: stdio, command: uvx, args: [coding-tools-mcp, --stdio, --workspace, /path/to/repo] } } }若使用本地 HTTP 服务器则改为type: http并填url与headers。更多客户端Windsurf、Gemini CLI、Cline 怎么配Windsurf编辑~/.codeium/windsurf/mcp_config.json格式与通用 JSON 相同Gemini CLI一条命令搞定gemini mcp add coding-tools -- uvx coding-tools-mcp --stdio --workspace /path/to/repoCline 及其他 HTTP 客户端直接指向http://127.0.0.1:8765/mcp。完整分客户端说明见 docs/mcp-client-config.md。 三大权限模式怎么选让 AI 安全地写代码exec_command提供三档权限决定 AI 能放开手脚到什么程度模式适用场景放行范围safe默认日常 agent 工作文件工具与常规命令联网、shell 展开、内联脚本、破坏性命令都需显式授权trusted本地开发额外放开网络下载、shell 展开与内联脚本仍保留敏感值过滤dangerous仅限隔离容器/虚拟机关闭exec_command权限门工作区路径边界依然生效配置方法是在启动参数里加--permission-mode trusted按需选择。新手建议先用默认safe本地开发再切trusteddangerous千万不要在裸机上用。详细规则与--write-path等工作区写策略见 docs/permission-modes.md。️ MCP 客户端常见问题连接失败与权限报错快速排查现象原因与解决客户端弹不出授权确认框request_permissions返回ELICITATION_UNSUPPORTED改用--permission-mode trusted本地开发场景直接放行网络与内联脚本exec_command提示SANDBOX_UNAVAILABLEWindows/macOS 或非 Landlock 内核的 Linux 无内核级隔离命令仍受服务端策略检查跑不可信代码请套 Docker命令长时间运行用write_stdin空输入轮询状态或kill_command终止MSVC、CUDA 等工具链找不到环境变量启动时加CODING_TOOLS_MCP_SHELL_ENV_INHERITall继承终端环境想关闭匿名遥测设置CODING_TOOLS_MCP_TELEMETRYoff或DO_NOT_TRACK1本地调试时可用CODING_TOOLS_MCP_TRACE1打开工具调用追踪JSON 行输出到 stderr。更多排障细节见 docs/troubleshooting.md 与 docs/troubleshooting-exec.md。 进阶路线从本地到远程 MCP 沙箱跑通本地之后coding-tools-mcp 还有几条进阶路线远程 MCPintegrations/tunnels/自带 cloudflared / ngrok / Dev Tunnel 脚本一行命令把服务器挂到带 Bearer Token 认证的 HTTPS 隧道后面手机上的 claude.ai 也能驱动家里的工作站 → docs/remote-mcp.mdDocker 沙箱构建仓库自带镜像把 agent 放进一次性容器跑不可信代码用完即毁 → docs/docker.md图形界面pip install coding-tools-mcp[desktop]后运行coding-tools-mcp-desktop按工作区管理配置、一键启停服务器与隧道支持简体中文源码见 apps/desktop-client/。 延伸阅读快速开始与启动参数docs/quickstart.md全客户端配置参考docs/mcp-client-config.md工具目录与 Schemadocs/tools-and-schemas.md安全策略SECURITY.md遥测说明docs/telemetry.md配置完成后对你的客户端说一句跑一下测试把第一个失败修了——你的 MCP 客户端配置就完成了AI 正式开工。赞分享【免费下载链接】coding-tools-mcpGive any AI agent the ability to code项目地址https://gitcode.com/gh_mirrors/co/coding-tools-mcp点击查看免费下载相关推荐mcp-for-beginners 实战指南在 Claude Desktop、VS Code、Cursor、Cline 与 Windsurf 中配置主流 MCP Host 客户端mcp for beginners 实战指南在 Claude Desktop、VS Code、Cursor、Cline 与 Windsurf 中配置主流 MC教程文档人工智能MCP 主机客户端配置实战Claude Desktop、VS Code、Cursor、Cline 与 Windsurf 接入指南MCP 主机客户端配置实战Claude Desktop、VS Code、Cursor、Cline 与 Windsurf 接入指南 本文以 mcp for be教程文档人工智能MCP Host 客户端接入实战在 mcp-for-beginners 中配置 Claude Desktop、VS Code、Cursor、Cline 与 WindsurfMCP Host 客户端接入实战在 mcp for beginners 中配置 Claude Desktop、VS Code、Cursor、Cline 与 W教程文档人工智能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考