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會暴露所有明確的工具。
操作工作流程
- 確認 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-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"
}
}
}
}
- 審慎選擇工具設定檔:
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 對話文字、閘道健康狀態、清理狀態以及外部模型佇列行為視為環境特定,直到重新驗證為止。