TRAECNclaw MCP 是做什么的?
概述
通过其真实的 stdio MCP 服务器使用 TRAECNclaw,该服务器由本地 HTTP 网关和 TraeCN CDP 自动化支持。在不同代理间保持此技能的可移植性:从服务器发现当前能力,在产生副作用之前调用紧凑的准备工具,并通过仓库脚本或 MCP 响应验证声明。
代理合约
- 将此技能视为客户端中立的技能,适用于任何能够读取指令并调用 stdio MCP 工具的代理。
- 当 MCP 服务器能够执行操作时,不要依赖仅限 Codex 的工具、浏览器自动化、计算机使用或手动 UI 控制。
- 使用由
tools/list返回的 MCP 工具名称;stdio MCP 接口使用traecn_*名称,这些名称可能与 OpenClaw 包装器名称和稳定命令 ID 不同。 - 优先使用机器可读的输出(
traecn_get_capabilities、traecn_preflight、任务状态、证明状态),而非散文式截图或手动观察。 - 使生成的客户端配置示例可由调用者编辑:始终对本地检出使用绝对路径,并使用文档化的环境变量来表示主机、端口和令牌。
- 将
tools/list视为配置文件作用域。默认的public暴露常见的 20 个工具;TRAECN_MCP_TOOL_PROFILE=ops暴露操作工具;TRAECN_MCP_TOOL_PROFILE=full暴露所有显式工具。
操作工作流
- 确认 Node 22+ 可用,并且网关主机能够访问 TraeCN。
- 对于已发布的包安装,当包提供的
traecnclaw-mcp二进制文件位于代理主机的PATH中时,优先使用它:
{
"mcpServers": {
"traecn": {
"command": "traecnclaw-mcp",
"env": {
"TRAECN_HOST": "127.0.0.1",
"TRAECN_PORT": "8788",
"TRAECN_GATEWAY_TOKEN": "",
"TRAECN_MCP_TOOL_PROFILE": "public"
}
}
}
}
- 对于源代码检出,使用绝对路径配置 MCP 客户端
mcp-server.js:
{
"mcpServers": {
"traecn": {
"command": "node",
"args": ["/absolute/path/to/TRAECNclaw/mcp-server.js"],
"env": {
"TRAECN_HOST": "127.0.0.1",
"TRAECN_PORT": "8788",
"TRAECN_GATEWAY_TOKEN": "",
"TRAECN_MCP_TOOL_PROFILE": "public"
}
}
}
}
- 有意选择工具配置文件:通用代理使用
public,恢复/证明工作流使用ops,兼容性审计和低层诊断使用full。 - 需要时单独启动网关,使用
npm run start:gateway;仅在模拟模式开发时使用TRAECN_ENABLE_MOCK_BRIDGE=1 npm run start:gateway。 - 先发现再行动:列出 MCP 工具,调用
traecn_get_capabilities,然后使用预期的命令和参数调用traecn_preflight。 - 对于有副作用的操作,首先调用
traecn_plan_operation或traecn_preflight,并遵循任何确认、准备、队列或对话结果。 - 当客户端需要稳定的命令目录而非单独的 MCP 工具名称时,使用
traecn_list_commands加上traecn_run_command。
工具选择
- 短期任务:在干净的
traecn_preflight之后使用traecn_run_task。 - 长期或排队任务:使用
traecn_queue_task、traecn_wait_task和traecn_poll_task;在public配置中使用traecn_preflight获取队列状态,仅在full配置中使用traecn_get_queue_status。 - 代码审查:使用
traecn_review_code作为一流的审查操作。 - 模型和模式控制:使用
traecn_switch_model、traecn_switch_mode和traecn_create_chat。 - 通过 stdio MCP 管理设置:使用
traecn_get_settings和traecn_set_setting。 - 对话框:在
public配置中使用traecn_get_dialog_status和traecn_respond_dialog;仅在运行full兼容性配置时使用traecn_dismiss_dialog。 - 审查门、清理和恢复:使用
ops配置工具,例如traecn_get_review_gate_status、traecn_resolve_review_gate、traecn_restart_debug_session、清理工具和长队列证明工具。 - 无人值守工作流:在
public配置中使用traecn_run_unattended_workflow;仅从暴露它们的配置中使用直接的 Solo/证明/清理工具。 - 完整的当前目录和跨代理配置说明:在选择确切的 MCP 工具或配置客户端时,请阅读 references/mcp-surface.md。
配置文件规模
public:20 个工具。用于默认的已发布代理集成。ops:32 个工具。用于恢复、清理、Solo 对话控制以及长队列证明工作。full:36 个工具。用于审计、兼容性检查以及有意想要每个显式快捷方式的客户端。
验证
- 运行
node -e "console.log(require('./mcp-server').MCP_TOOLS.map(t => t.name).join('\n'))"以验证代码中的实时工具列表。 - 运行
npm run doctor进行本地环境准备情况检查。 - 行为更改后,运行
npm test以执行仓库内维护的测试序列。 - 在声明无人值守端到端 TraeCN 工作流准备就绪之前,运行
npm run acceptance:audit -- --require-complete。 - 对于发布风格的更改,如果可行,运行
npm run test:all。
安全规则
- 将网关绑定到
127.0.0.1,除非有意需要远程访问。 - 永远不要提交
.env、令牌、授权标头、原始 TraeCN 配置文件数据、audit-logs、demo-output、logs或node_modules。 - 当 MCP 服务器能够执行操作时,优先使用 MCP/HTTP/CLI 接口而非 GUI 控制路径。
- 将实时的 TraeCN 对话框文本、网关健康状态、清理状态以及外部模型队列行为视为环境特定,直到重新验证。