快速开始

安装、启动和验证 Coding Tools MCP 的最短路径。

​

快速开始

本页给出从安装到启动的最短路径，默认值来自当前代码实现。

​

前置要求

• Python >=3.11
• 支持 stdio 或 Streamable HTTP 的 MCP 客户端
• 一个你愿意暴露给编码工具的工作区目录

​

用 HTTP 启动

python -m pip install coding-tools-mcp
cd /path/to/workspace
coding-tools-mcp

默认监听地址是：

http://127.0.0.1:8000/mcp

也可以显式指定工作区：

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

​

用 stdio 启动

如果 MCP 客户端负责拉起服务进程，使用 --stdio：

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

stdio 传输从 stdin 读取逐行 JSON-RPC，并把响应写到 stdout。

​

验证 HTTP 元数据

HTTP 模式下可以先检查 /mcp：

curl http://127.0.0.1:8000/mcp

响应应包含服务器名称、协议版本、当前工具 profile 和工具列表信息。

​

第一次客户端调用

客户端完成 MCP initialize 后，调用 tools/list。默认 full profile 会暴露文件、搜索、补丁、命令、Git、权限和图片工具。read-only profile 会隐藏 apply_patch、exec_command、write_stdin、kill_session、set_default_cwd 和 request_permissions 等会改变状态的工具。

​

远程绑定需要鉴权

本地 loopback 可以无鉴权运行。绑定到非 loopback 地址时，代码要求 Bearer token 或 OAuth，除非显式配置 noauth：

coding-tools-mcp --host 0.0.0.0 --auth-token "$CODING_TOOLS_MCP_AUTH_TOKEN"

coding-tools-mcp --host 0.0.0.0 --oauth-mode

CODING_TOOLS_MCP_AUTH_MODE=noauth 只应放在已经由其他可信层保护的网络边界后面。

​

下一步

• 看 安装与配置 了解 CLI 参数和环境变量。
• 看 客户端接入 配置 MCP 客户端。
• 看 故障排查 处理连接、鉴权、权限和补丁问题。