Communitygithub.com

TRAECNclaw MCP

Utilisez cette compétence lorsque n'importe quel agent d'IA compatible MCP a besoin de se connecter, de configurer, d'exploiter, de tester ou de documenter le serveur MCP stdio de TRAECNclaw pour l'automatisation de TraeCN, l'intégration OpenClaw, les workflows de vapotage sans surveillance, le contrôle des paramètres/modèles/dialogues, la délégation de revue de code ou les preuves de file d'attente longue.

Qu'est-ce que TRAECNclaw MCP ?

Cette compétence permet à tout agent d'IA compatible MCP d'interagir pleinement avec le serveur MCP stdio de TRAECNclaw, soutenu par une passerelle HTTP locale et l'automatisation TraeCN CDP. Elle est conçue pour être portable entre différents agents, en privilégiant les outils de découverte comme `tools/list`, `traecn_get_capabilities` et `traecn_preflight` avant toute opération avec effets de bord. La compétence couvre trois profils d'outils (`public` pour les intégrations générales, `ops` pour la récupération et les preuves de file d'attente longue, `full` pour les audits de compatibilité) et fournit des instructions détaillées pour la configuration du client MCP, la sélection des outils et les workflows opérationnels. Elle met l'accent sur l'utilisation d'appels machine-à-machine plutôt que sur l'automatisation de navigateur ou le contrôle d'interface utilisateur manuel, garantissant ainsi une exécution fiable et rapide des tâches complexes dans des environnements sans surveillance.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait TRAECNclaw MCP ?

Présentation

Utilisez TRAECNclaw via son véritable serveur MCP stdio, soutenu par la passerelle HTTP locale et l'automatisation TraeCN CDP. Gardez cette compétence portable entre les agents : découvrez les capacités actuelles depuis le serveur, appelez des outils de vérification compacts avant les effets de bord, et vérifiez les affirmations avec les scripts du dépôt ou les réponses MCP.

Contrat de l'Agent

  • Traitez cela comme une compétence neutre pour le client, destinée à tout agent capable de lire des instructions et d'appeler des outils MCP stdio.
  • Ne dépendez pas d'outils exclusifs à Codex, d'automatisation de navigateur, d'utilisation de l'ordinateur ou de contrôle manuel de l'interface utilisateur lorsque le serveur MCP peut effectuer l'opération.
  • Utilisez les noms des outils MCP renvoyés par tools/list ; la surface MCP stdio utilise des noms traecn_* qui peuvent différer des noms des wrappers OpenClaw et des ID de commande stables.
  • Préférez les sorties lisibles par machine (traecn_get_capabilities, traecn_preflight, statut des tâches, statut des preuves) aux captures d'écran en prose ou à l'observation manuelle.
  • Gardez les exemples de configuration client générés modifiables par l'appelant : utilisez toujours des chemins absolus pour les dépôts locaux et des variables d'environnement documentées pour l'hôte, le port et le jeton.
  • Traitez tools/list comme étant limité au profil. Par défaut, public expose les 20 outils courants ; TRAECN_MCP_TOOL_PROFILE=ops expose les outils opérationnels ; TRAECN_MCP_TOOL_PROFILE=full expose tous les outils explicites.

Workflow Opérationnel

  1. Confirmez que Node 22+ est disponible et que l'hôte de la passerelle peut atteindre TraeCN.
  2. Pour une installation via un package publié, préférez le binaire traecnclaw-mcp fourni par le package s'il se trouve dans le PATH de l'agent hôte :
{
  "mcpServers": {
    "traecn": {
      "command": "traecnclaw-mcp",
      "env": {
        "TRAECN_HOST": "127.0.0.1",
        "TRAECN_PORT": "8788",
        "TRAECN_GATEWAY_TOKEN": "",
        "TRAECN_MCP_TOOL_PROFILE": "public"
      }
    }
  }
}
  1. Pour une vérification à partir des sources, configurez le client MCP avec un chemin absolu vers mcp-server.js :
{
  "mcpServers": {
    "traecn": {
      "command": "node",
      "args": ["/chemin/absolu/vers/TRAECNclaw/mcp-server.js"],
      "env": {
        "TRAECN_HOST": "127.0.0.1",
        "TRAECN_PORT": "8788",
        "TRAECN_GATEWAY_TOKEN": "",
        "TRAECN_MCP_TOOL_PROFILE": "public"
      }
    }
  }
}
  1. Choisissez un profil d'outils délibérément : public pour les agents généraux, ops pour les workflows de récupération/preuve, full pour les audits de compatibilité et les diagnostics de bas niveau.
  2. Démarrez la passerelle séparément si nécessaire avec npm run start:gateway ; utilisez TRAECN_ENABLE_MOCK_BRIDGE=1 npm run start:gateway uniquement pour le développement en mode simulé.
  3. Découvrez avant d'agir : listez les outils MCP, appelez traecn_get_capabilities, puis appelez traecn_preflight avec la commande et les paramètres prévus.
  4. Pour les opérations avec effets de bord, appelez d'abord traecn_plan_operation ou traecn_preflight et respectez tout résultat de confirmation, de préparation, de file d'attente ou de dialogue.
  5. Utilisez traecn_list_commands avec traecn_run_command lorsqu'un client a besoin du catalogue de commandes stables plutôt que des noms d'outils MCP individuels.

Sélection d'Outils

  • Tâches courtes : utilisez traecn_run_task après un traecn_preflight propre.
  • Tâches longues ou en file d'attente : utilisez traecn_queue_task, traecn_wait_task et traecn_poll_task ; utilisez traecn_preflight pour l'état de la file d'attente dans public, ou traecn_get_queue_status uniquement dans full.
  • Revue de code : utilisez traecn_review_code comme action de révision de première classe.
  • Contrôle des modèles et modes : utilisez traecn_switch_model, traecn_switch_mode et traecn_create_chat.
  • Paramètres via MCP stdio : utilisez traecn_get_settings et traecn_set_setting.
  • Dialogues : utilisez traecn_get_dialog_status et traecn_respond_dialog dans public ; utilisez traecn_dismiss_dialog uniquement lorsque vous exécutez le profil de compatibilité full.
  • Portes de révision, nettoyage et récupération : utilisez les outils du profil ops tels que traecn_get_review_gate_status, traecn_resolve_review_gate, traecn_restart_debug_session, les outils de nettoyage et les outils de preuve de file d'attente longue.
  • Workflows sans surveillance : utilisez traecn_run_unattended_workflow dans public ; utilisez les outils directs Solo/preuve/nettoyage uniquement à partir du profil qui les expose.
  • Catalogue complet actuel et notes de configuration multi-agents : lisez references/mcp-surface.md lors du choix d'un outil MCP exact ou de la configuration d'un client.

Échelle des Profils

  • public : 20 outils. Utilisez pour les intégrations d'agents publiées par défaut.
  • ops : 32 outils. Utilisez pour la récupération, le nettoyage, le contrôle des conversations Solo et le travail de preuve de file d'attente longue.
  • full : 36 outils. Utilisez pour les audits, les vérifications de compatibilité et les clients qui souhaitent intentionnellement tous les raccourcis explicites.

Validation

  • Exécutez node -e "console.log(require('./mcp-server').MCP_TOOLS.map(t => t.name).join('\n'))" pour vérifier la liste d'outils en direct depuis le code.
  • Exécutez npm run doctor pour la préparation de l'environnement local.
  • Exécutez npm test pour la séquence de tests maintenue dans le dépôt après les changements de comportement.
  • Exécutez npm run acceptance:audit -- --require-complete avant de revendiquer la préparation d'un workflow TraeCN de bout en bout sans surveillance.
  • Pour les changements de type version, exécutez npm run test:all lorsque c'est pratique.

Règles de Sécurité

  • Gardez la passerelle liée à 127.0.0.1 sauf si un accès à distance est intentionnellement requis.
  • Ne commettez jamais .env, les jetons, les en-têtes d'autorisation, les données brutes du profil TraeCN, audit-logs, demo-output, logs ou node_modules.
  • Préférez les surfaces MCP/HTTP/CLI aux chemins de contrôle d'interface utilisateur graphique lorsque le serveur MCP peut effectuer l'opération.
  • Traitez le texte de dialogue TraeCN en direct, la santé de la passerelle, l'état de nettoyage et le comportement de la file d'attente des modèles externes comme spécifiques à l'environnement jusqu'à revalidation.

Skills associés