跳转到主要内容

​
安装与配置

Coding Tools MCP 是一个 Python 包，安装后提供 coding-tools-mcp 命令。

​
安装

python -m pip install coding-tools-mcp
包要求 Python >=3.11，运行时依赖包含 PyJWT。开发依赖可使用 coding-tools-mcp[dev]，图片能力相关依赖可使用 coding-tools-mcp[image]。

​
核心 CLI 参数

参数默认值用途
--workspaceCODING_TOOLS_MCP_WORKSPACE 或当前目录暴露给文件工具和命令执行的工作区根目录。
--hostCODING_TOOLS_MCP_HOST 或 127.0.0.1HTTP 绑定地址。
--portCODING_TOOLS_MCP_PORT 或 8000HTTP 绑定端口。
--stdiofalse使用逐行 JSON-RPC stdio，而不是 HTTP。
--auth-tokenCODING_TOOLS_MCP_AUTH_TOKEN要求 /mcp 请求携带 Authorization: Bearer <token>。
--oauth-modefalse启用 OAuth 2.1 Authorization Code + PKCE。
--tool-profileCODING_TOOLS_MCP_TOOL_PROFILE 或 full控制暴露哪些 MCP 工具。
--shell-env-inheritCODING_TOOLS_MCP_SHELL_ENV_INHERIT 或 core控制 exec_command 继承的基础环境变量。
--permission-mode运行时策略默认值控制 exec_command 的安全门禁。
--allow-networkfalse兼容别名：允许带网络特征的命令调用。
--enable-view-image默认启用，除非 CODING_TOOLS_MCP_ENABLE_VIEW_IMAGE=0暴露 view_image。
--dangerously-skip-all-permissionsfalse兼容别名：等价于 --permission-mode dangerous。

​
传输方式

HTTP： 
coding-tools-mcp --workspace /repo --host 127.0.0.1 --port 8000
请求入口是 /mcp，元数据也可从 /.well-known/mcp.json 和 /.well-known/mcp/server-card.json 获取。 Stdio： 
coding-tools-mcp --stdio --workspace /repo
stdio 适合由客户端直接管理 MCP server 子进程的场景。

​
鉴权

本地 loopback HTTP 可以无鉴权。非 loopback 绑定需要以下之一：
  • --auth-token 或 CODING_TOOLS_MCP_AUTH_TOKEN
  • --oauth-mode 或 CODING_TOOLS_MCP_OAUTH_MODE=1
  • CODING_TOOLS_MCP_AUTH_MODE=noauth，仅用于外层已有可信鉴权和网络隔离的部署
CODING_TOOLS_MCP_AUTH_MODE 可取 bearer、noauth、oauth。 OAuth 相关环境变量包括：
  • CODING_TOOLS_MCP_OAUTH_CLIENT_ID
  • CODING_TOOLS_MCP_OAUTH_CLIENT_SECRET
  • CODING_TOOLS_MCP_OAUTH_PASSWORD
  • CODING_TOOLS_MCP_SERVER_URL
  • CODING_TOOLS_MCP_OAUTH_TOKEN_SECRET
  • CODING_TOOLS_MCP_OAUTH_TOKEN_TTL
如果未设置 OAuth password 或 token secret，服务会在运行时生成值，并把授权密码打印到 stderr。

​
工具 profile

Profile行为
full暴露完整实现的工具集合。
read-only隐藏会改变文件、进程状态或权限状态的工具。
compat-readonly-all为兼容客户端把工具注解为只读，但其中一些工具仍可能改变本地状态。

​
权限模式

模式网络特征命令Shell 展开和内联脚本Landlock敏感环境过滤
safe阻止阻止可用时启用启用
trusted允许允许可用时启用启用
dangerous允许允许禁用禁用
本地开发中需要包管理器、测试命令或 shell 特性时，通常使用 trusted。只有外层沙箱已经提供真实隔离时，才考虑 dangerous。

​
命令环境

exec_command 使用受控环境。--shell-env-inherit 支持：
  • core：继承 PATH、locale 等核心变量。
  • all：继承进程环境，但仍受过滤影响。
  • none：从空基础环境开始，只使用显式设置。
不要把 token、私钥、API key 或密码放入 exec_command.env。在 safe 和 trusted 中，敏感名称、敏感值和风险 loader/startup 变量会被过滤。

​
运行时文件

默认运行时根目录位于系统临时目录下的 coding-tools-mcp。设置 CODING_TOOLS_MCP_RUNTIME_ROOT 可以覆盖该位置。