Communitygithub.com

TRAECNclaw MCP

MCP対応のAIエージェントがTRAECNclawのstdio MCPサーバーに接続・設定・操作・テスト・ドキュメント化するためのスキルです。TraeCNの自動化、OpenClaw統合、無人vibeワークフロー、設定/モデル/ダイアログ制御、コードレビュー委任、長時間キュー処理などを実現します。

TRAECNclaw MCP とは?

このスキルは、MCP(Model Context Protocol)対応のAIエージェントがTRAECNclawのstdio MCPサーバーを介してTraeCNの全機能を操作できるようにします。バックエンドはローカルHTTPゲートウェイとTraeCN CDP自動化で構成され、エージェントはツール一覧の動的取得、準備状態確認ツールの呼び出し、副作用のある操作前の事前チェックなどを通じて安全かつ効率的に作業を進められます。Claude Code、Cursor、Codexなどの任意のMCPクライアントで使用可能で、ブラウザ自動化やGUI操作に依存せず、機械可読な出力(能力一覧、プリフライトステータス、タスク状態)を優先します。ツールプロファイルは`public`(20ツール、デフォルト)、`ops`(32ツール、復旧・クリーンアップ・長時間キュー処理向け)、`full`(36ツール、監査・互換性診断向け)から選択でき、環境変数でホスト・ポート・トークン・プロファイルを設定可能です。コードレビュー、モデル/モード切替、キュー投入・待機・確認、無人ワークフロー実行など、TraeCNの主要操作をMCPツールとして統一的に提供します。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

TRAECNclaw MCP は何をしますか?

概要

TRAECNclawを、実際のstdio MCPサーバー(ローカル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. 公開パッケージインストールの場合は、エージェントホストの PATH にあれば、パッケージが提供する traecnclaw-mcp バイナリを優先します。
{
  "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 を使用します。traecn_dismiss_dialog は full 互換性プロファイルを実行している場合にのみ使用します。
  • レビューゲート、クリーンアップ、復旧: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サーバーが操作を実行できる場合は、GUI制御パスよりもMCP/HTTP/CLIサーフェスを優先します。
  • 実際のTraeCNダイアログテキスト、ゲートウェイの健全性、クリーンアップ状態、外部モデルキューの動作は、再検証されるまで環境固有のものとして扱ってください。

関連スキル