Communitygithub.com

TRAECNclaw MCP

當任何支援 MCP 的 AI 代理需要連接、配置、操作、測試或記錄 TRAECNclaw 的 stdio MCP 伺服器時使用。此技能專為需要真實 MCP 工具介面而非直接瀏覽器或 GUI 控制的代理設計。

TRAECNclaw MCP 是什麼?

TRAECNclaw MCP 技能提供了一個完整的 stdio MCP 伺服器介面,用於控制 TraeCN 自動化、OpenClaw 整合、無人值守工作流程、設定/模型/對話控制、程式碼審查委派以及長時間佇列驗證。技能支援三大工具設定檔:`public`(20 個工具,適用於一般代理整合)、`ops`(32 個工具,適用於恢復、清理、Solo 對話控制與長時間佇列驗證)、以及 `full`(36 個工具,適用於稽核與相容性檢查)。工作流程強調「先發現再行動」:代理應先列出 MCP 工具、呼叫 `traecn_get_capabilities`,然後為任何副作用操作執行 `traecn_preflight`。此技能可攜帶於不同代理之間,支援基於 npm 套件的安裝與原始碼結出的 MCP 客戶端配置,並內建安全規則,防止機密資料洩漏及未授權的遠端存取。

相容平台~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 的工具、瀏覽器自動化、Computer Use 或手動 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-server.js 路徑來配置 MCP 客戶端:
{
  "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 對話文字、閘道健康狀態、清理狀態以及外部模型佇列行為視為環境特定,直到重新驗證為止。

相關技能