Communitygithub.com

TRAECNclaw MCP

适用于任何支持MCP的AI代理连接、配置、操作、测试或记录TRAECNclaw的stdio MCP服务器,用于TraeCN自动化、OpenClaw集成、无人值守vibe工作流、设置/模型/对话控制、代码审查委托或长队列验证运行。当代理需要真实的MCP工具接口而非直接浏览器或GUI控制时,优先使用此技能。

TRAECNclaw MCP 是什么?

TRAECNclaw MCP 技能为任何支持 MCP 的 AI 代理(如 Claude Code、Cursor、Codex 等)提供了一种标准化的接口,以连接、配置和操作 TRAECNclaw 的 stdio MCP 服务器。此服务器由本地 HTTP 网关和 TraeCN CDP 自动化支持,允许代理执行诸如代码审查、模型切换、对话管理、队列任务处理以及无人值守工作流等操作,而无需依赖专有工具或直接的 GUI 交互。该技能强调可移植性,并作为客户端无关的合约运行,代理可以动态发现工具、通过 `traecn_get_capabilities` 验证能力,并使用 `traecn_preflight` 进行无副作用的安全检查。它支持三种工具配置文件——`public`(默认 20 个工具)、`ops`(32 个工具,用于恢复和队列证明)和 `full`(36 个工具,用于低层级诊断)——允许代理根据任务复杂度选择合适的工具集。关键的工作流包括通过 `traecn_run_task` 运行短期任务,通过 `traecn_queue_task` 处理长期任务,以及通过 `traecn_review_code` 进行代码审查。该技能还通过 `npm run doctor` 和 `npm test` 等内置脚本提供验证,并通过在生成的客户端配置中使用绝对路径和记录的环境变量来确保安全性。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Luckycat133/traecnclaw-mcp-skill/tree/main/.codex/skills/traecnclaw-mcp

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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 暴露所有显式工具。

操作工作流

  1. 确认 Node 22+ 可用,并且网关主机能够访问 TraeCN。
  2. 对于已发布的包安装,当包提供的 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"
      }
    }
  }
}
  1. 对于源代码检出,使用绝对路径配置 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"
      }
    }
  }
}
  1. 有意选择工具配置文件:通用代理使用 public,恢复/证明工作流使用 ops,兼容性审计和低层诊断使用 full。
  2. 需要时单独启动网关,使用 npm run start:gateway;仅在模拟模式开发时使用 TRAECN_ENABLE_MOCK_BRIDGE=1 npm run start:gateway。
  3. 先发现再行动:列出 MCP 工具,调用 traecn_get_capabilities,然后使用预期的命令和参数调用 traecn_preflight。
  4. 对于有副作用的操作,首先调用 traecn_plan_operation 或 traecn_preflight,并遵循任何确认、准备、队列或对话结果。
  5. 当客户端需要稳定的命令目录而非单独的 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 对话框文本、网关健康状态、清理状态以及外部模型队列行为视为环境特定,直到重新验证。

相关技能