Communitygithub.com

TRAECNclaw MCP

Verwenden Sie diese Fähigkeit, wenn ein MCP-fähiger KI-Agent den stdio MCP-Server von TRAECNclaw für TraeCN-Automatisierung, OpenClaw-Integration, unbeaufsichtigte Vibe-Workflows, Einstellungs-/Modell-/Dialogsteuerung, Code-Review-Delegierung oder Long-Queue-Nachweisläufe verbinden, konfigurieren, betreiben, testen oder dokumentieren muss. Bevorzugen Sie diese Fähigkeit, wenn ein Agent die echte MCP-Tool-Oberfläche anstelle einer direkten Browser- oder GUI-Steuerung benötigt.

Was ist TRAECNclaw MCP?

Der TRAECNclaw MCP-Skill stellt einen stdio MCP-Server bereit, der eine lokale HTTP-Gateway- und TraeCN-CDP-Automatisierung nutzt. Er ermöglicht es jedem MCP-fähigen KI-Agenten, auf eine Sammlung von MCP-Tools zuzugreifen, um TraeCN-basierte Arbeitsabläufe wie Code-Reviews, Einstellungs- und Dialogsteuerung, unbeaufsichtigte Workflows und Aufgabenwarteschlangen zu automatisieren. Der Skill ist agentenneutral konzipiert und verwendet ein Profilsystem (`public`, `ops`, `full`), um je nach Anwendungsfall die geeignete Tool-Oberfläche verfügbar zu machen. Agenten sollten Tools wie `traecn_preflight` für Bereitschaftsprüfungen und `tools/list` für die Ermittlung der verfügbaren Fähigkeiten vor Aktionen mit Seiteneffekten verwenden. Er unterstützt Claude Code, Cursor, Codex und andere MCP-fähige Agenten und bietet sowohl gepackte Binärdateien als auch Quellcode-Checkout-Konfigurationsoptionen mit absoluten Pfaden und dokumentierten Umgebungsvariablen für Host, Port und Token.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht TRAECNclaw MCP?

Überblick

Verwenden Sie TRAECNclaw über seinen echten stdio MCP-Server, der durch das lokale HTTP-Gateway und die TraeCN-CDP-Automatisierung unterstützt wird. Halten Sie diesen Skill portabel über Agenten hinweg: Entdecken Sie aktuelle Fähigkeiten vom Server, rufen Sie kompakte Bereitschaftstools vor Seiteneffekten auf und überprüfen Sie Behauptungen mit Repository-Skripten oder MCP-Antworten.

Agentenvertrag

  • Behandeln Sie dies als einen clientneutralen Skill für jeden Agenten, der Anweisungen lesen und stdio-MCP-Tools aufrufen kann.
  • Verlassen Sie sich nicht auf Codex-exklusive Tools, Browserautomatisierung, Computer Use oder manuelle UI-Steuerung, wenn der MCP-Server die Operation ausführen kann.
  • Verwenden Sie die von tools/list zurückgegebenen MCP-Toolnamen; die stdio-MCP-Oberfläche verwendet traecn_*-Namen, die sich von OpenClaw-Wrappernamen und stabilen Befehls-IDs unterscheiden können.
  • Bevorzugen Sie maschinenlesbare Ausgaben (traecn_get_capabilities, traecn_preflight, Aufgabenstatus, Nachweisstatus) gegenüber Prosa-Screenshots oder manueller Beobachtung.
  • Halten Sie generierte Client-Konfigurationsbeispiele vom Aufrufer bearbeitbar: Verwenden Sie immer absolute Pfade für lokale Checkouts und dokumentierte Umgebungsvariablen für Host, Port und Token.
  • Behandeln Sie tools/list als profilspezifisch. Standardmäßig public zeigt die allgemeinen 20 Tools an; TRAECN_MCP_TOOL_PROFILE=ops zeigt operative Tools an; TRAECN_MCP_TOOL_PROFILE=full zeigt jedes explizite Tool an.

Betriebsablauf

  1. Stellen Sie sicher, dass Node 22+ verfügbar ist und der Gateway-Host TraeCN erreichen kann.
  2. Für eine veröffentlichte Paketinstallation bevorzugen Sie die paketbereitgestellte traecnclaw-mcp-Binärdatei, wenn sie sich im Agenten-Host-PATH befindet:
{
  "mcpServers": {
    "traecn": {
      "command": "traecnclaw-mcp",
      "env": {
        "TRAECN_HOST": "127.0.0.1",
        "TRAECN_PORT": "8788",
        "TRAECN_GATEWAY_TOKEN": "",
        "TRAECN_MCP_TOOL_PROFILE": "public"
      }
    }
  }
}
  1. Für einen Quellcode-Checkout konfigurieren Sie den MCP-Client mit einem absoluten mcp-server.js-Pfad:
{
  "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. Wählen Sie ein Tool-Profil bewusst aus: public für allgemeine Agenten, ops für Wiederherstellungs-/Nachweis-Workflows, full für Kompatibilitätsprüfungen und Low-Level-Diagnostik.
  2. Starten Sie das Gateway bei Bedarf separat mit npm run start:gateway; verwenden Sie TRAECN_ENABLE_MOCK_BRIDGE=1 npm run start:gateway nur für die Mock-Modus-Entwicklung.
  3. Entdecken Sie, bevor Sie handeln: Listen Sie MCP-Tools auf, rufen Sie traecn_get_capabilities auf, dann rufen Sie traecn_preflight mit dem beabsichtigten Befehl und den Parametern auf.
  4. Rufen Sie für Operationen mit Seiteneffekten zuerst traecn_plan_operation oder traecn_preflight auf und beachten Sie alle Bestätigungs-, Bereitschafts-, Warteschlangen- oder Dialogergebnisse.
  5. Verwenden Sie traecn_list_commands plus traecn_run_command, wenn ein Client den stabilen Befehls-Katalog anstelle einzelner MCP-Toolnamen benötigt.

Tool-Auswahl

  • Kurze Aufgaben: Verwenden Sie traecn_run_task nach einem sauberen traecn_preflight.
  • Lange oder in der Warteschlange befindliche Aufgaben: Verwenden Sie traecn_queue_task, traecn_wait_task und traecn_poll_task; verwenden Sie traecn_preflight für den Warteschlangenstatus in public oder traecn_get_queue_status nur in full.
  • Code-Review: Verwenden Sie traecn_review_code als erstklassige Review-Aktion.
  • Modell- und Modussteuerung: Verwenden Sie traecn_switch_model, traecn_switch_mode und traecn_create_chat.
  • Einstellungen über stdio MCP: Verwenden Sie traecn_get_settings und traecn_set_setting.
  • Dialoge: Verwenden Sie traecn_get_dialog_status und traecn_respond_dialog in public; verwenden Sie traecn_dismiss_dialog nur, wenn Sie das full-Kompatibilitätsprofil ausführen.
  • Review-Gates, Bereinigung und Wiederherstellung: Verwenden Sie die Tools des ops-Profils wie traecn_get_review_gate_status, traecn_resolve_review_gate, traecn_restart_debug_session, Bereinigungstools und Long-Queue-Nachweis-Tools.
  • Unbeaufsichtigte Workflows: Verwenden Sie traecn_run_unattended_workflow in public; verwenden Sie direkte Solo-/Nachweis-/Bereinigungstools nur aus dem Profil, das sie bereitstellt.
  • Vollständiger aktueller Katalog und agentenübergreifende Konfigurationshinweise: Lesen Sie references/mcp-surface.md, wenn Sie ein genaues MCP-Tool auswählen oder einen Client konfigurieren.

Profilumfang

  • public: 20 Tools. Für standardmäßige veröffentlichte Agentenintegrationen verwenden.
  • ops: 32 Tools. Für Wiederherstellung, Bereinigung, Solo-Gesprächssteuerung und Long-Queue-Nachweisarbeit verwenden.
  • full: 36 Tools. Für Audits, Kompatibilitätsprüfungen und Clients, die absichtlich jeden expliziten Shortcut wünschen.

Validierung

  • Führen Sie node -e "console.log(require('./mcp-server').MCP_TOOLS.map(t => t.name).join('\n'))" aus, um die Live-Tool-Liste aus dem Code zu überprüfen.
  • Führen Sie npm run doctor für die Bereitschaft der lokalen Umgebung aus.
  • Führen Sie npm test für die verwaltete In-Repo-Testsequenz nach Verhaltensänderungen aus.
  • Führen Sie npm run acceptance:audit -- --require-complete aus, bevor Sie die Bereitschaft für unbeaufsichtigte End-to-End-TraeCN-Workflows behaupten.
  • Führen Sie für änderungen im Release-Stil nach Möglichkeit npm run test:all aus.

Sicherheitsregeln

  • Halten Sie das Gateway an 127.0.0.1 gebunden, es sei denn, Fernzugriff ist absichtlich erforderlich.
  • Committen Sie niemals .env, Tokens, Autorisierungsheader, rohe TraeCN-Profil-Daten, audit-logs, demo-output, logs oder node_modules.
  • Bevorzugen Sie MCP/HTTP/CLI-Oberflächen gegenüber GUI-Steuerungspfaden, wenn der MCP-Server die Operation ausführen kann.
  • Behandeln Sie Live-TraeCN-Dialogtext, Gateway-Status, Bereinigungszustand und externes Modell-Warteschlangenverhalten als umgebungsspezifisch, bis sie erneut validiert werden.

Verwandte Skills