Communitygithub.com

TRAECNclaw MCP

Conecta, configura, opera, prueba y documenta el servidor MCP stdio de TRAECNclaw para automatización de TraeCN, integración con OpenClaw, flujos de trabajo no supervisados, control de configuraciones/modelos/diálogos, delegación de revisiones de código y ejecuciones de cola larga.

¿Qué es TRAECNclaw MCP?

Esta habilidad proporciona a cualquier agente de IA compatible con MCP la capacidad de interactuar directamente con el servidor MCP stdio de TRAECNclaw. Su principal ventaja es ofrecer una superficie de herramientas reales (MCP) en lugar de depender de control manual del navegador o interfaces GUI, lo que permite automatización más robusta y confiable. Es útil para desarrolladores y agentes que necesitan gestionar flujos de trabajo en TraeCN: desde tareas cortas y revisiones de código hasta operaciones en cola, control de modelos y modos, manejo de diálogos, y pruebas de extremo a extremo. La habilidad es portable entre agentes, funciona con Node 22+ y se configura mediante variables de entorno. Soporta tres perfiles de herramientas: `public` (20 herramientas para uso general), `ops` (32 herramientas para recuperación y flujos de cola larga) y `full` (36 herramientas para auditorías y diagnóstico completo). El flujo de trabajo recomendado es descubrir capacidades con `traecn_get_capabilities`, verificar disponibilidad con `traecn_preflight` antes de operaciones con efectos secundarios, y usar herramientas específicas según la tarea. Los agentes deben usar nombres de herramientas MCP (prefijo `traecn_*`) y prefieren salidas legibles por máquina sobre descripciones textuales.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace TRAECNclaw MCP?

Descripción General

Usa TRAECNclaw a través de su servidor MCP stdio real, respaldado por la puerta de enlace HTTP local y la automatización CDP de TraeCN. Mantén esta habilidad portable entre agentes: descubre las capacidades actuales desde el servidor, llama a herramientas compactas de preparación antes de efectos secundarios y verifica afirmaciones con scripts del repositorio o respuestas MCP.

Contrato del Agente

  • Trata esto como una habilidad neutral al cliente para cualquier agente que pueda leer instrucciones y llamar a herramientas MCP stdio.
  • No dependas de herramientas exclusivas de Codex, automatización del navegador, Computer Use o control manual de la interfaz de usuario cuando el servidor MCP pueda realizar la operación.
  • Usa los nombres de herramientas MCP devueltos por tools/list; la superficie MCP stdio usa nombres traecn_* que pueden diferir de los nombres del envoltorio OpenClaw y los IDs de comando estables.
  • Prefiere salidas legibles por máquina (traecn_get_capabilities, traecn_preflight, estado de tarea, estado de comprobación) sobre capturas de pantalla en prosa u observación manual.
  • Mantén los ejemplos de configuración de cliente generados editables por el llamador: usa siempre rutas absolutas para los repositorios locales y variables de entorno documentadas para host, puerto y token.
  • Trata tools/list como un ámbito de perfil. El perfil public predeterminado expone las 20 herramientas comunes; TRAECN_MCP_TOOL_PROFILE=ops expone herramientas operativas; TRAECN_MCP_TOOL_PROFILE=full expone todas las herramientas explícitas.

Flujo de Trabajo Operativo

  1. Confirma que Node 22+ está disponible y que el host de la puerta de enlace puede alcanzar TraeCN.
  2. Para una instalación de paquete publicado, prefiere el binario traecnclaw-mcp proporcionado por el paquete cuando esté en el PATH del host del agente:
{
  "mcpServers": {
    "traecn": {
      "command": "traecnclaw-mcp",
      "env": {
        "TRAECN_HOST": "127.0.0.1",
        "TRAECN_PORT": "8788",
        "TRAECN_GATEWAY_TOKEN": "",
        "TRAECN_MCP_TOOL_PROFILE": "public"
      }
    }
  }
}
  1. Para un repositorio local, configura el cliente MCP con una ruta absoluta a mcp-server.js:
{
  "mcpServers": {
    "traecn": {
      "command": "node",
      "args": ["/ruta/absoluta/hacia/TRAECNclaw/mcp-server.js"],
      "env": {
        "TRAECN_HOST": "127.0.0.1",
        "TRAECN_PORT": "8788",
        "TRAECN_GATEWAY_TOKEN": "",
        "TRAECN_MCP_TOOL_PROFILE": "public"
      }
    }
  }
}
  1. Elige un perfil de herramientas deliberadamente: public para agentes generales, ops para flujos de recuperación/comprobación, full para auditorías de compatibilidad y diagnósticos de bajo nivel.
  2. Inicia la puerta de enlace por separado cuando sea necesario con npm run start:gateway; usa TRAECN_ENABLE_MOCK_BRIDGE=1 npm run start:gateway solo para desarrollo en modo simulado.
  3. Descubre antes de actuar: lista las herramientas MCP, llama a traecn_get_capabilities, luego llama a traecn_preflight con el comando y parámetros previstos.
  4. Para operaciones con efectos secundarios, llama primero a traecn_plan_operation o traecn_preflight y respeta cualquier resultado de confirmación, preparación, cola o diálogo.
  5. Usa traecn_list_commands junto con traecn_run_command cuando un cliente necesite el catálogo de comandos estables en lugar de nombres individuales de herramientas MCP.

Selección de Herramientas

  • Tareas cortas: usa traecn_run_task después de un traecn_preflight limpio.
  • Tareas largas o en cola: usa traecn_queue_task, traecn_wait_task y traecn_poll_task; usa traecn_preflight para el estado de la cola en public, o traecn_get_queue_status solo en full.
  • Revisión de código: usa traecn_review_code como acción de revisión de primera clase.
  • Control de modelo y modo: usa traecn_switch_model, traecn_switch_mode y traecn_create_chat.
  • Configuraciones a través de MCP stdio: usa traecn_get_settings y traecn_set_setting.
  • Diálogos: usa traecn_get_dialog_status y traecn_respond_dialog en public; usa traecn_dismiss_dialog solo cuando ejecutes el perfil de compatibilidad full.
  • Puertas de revisión, limpieza y recuperación: usa las herramientas del perfil ops como traecn_get_review_gate_status, traecn_resolve_review_gate, traecn_restart_debug_session, herramientas de limpieza y herramientas de comprobación de cola larga.
  • Flujos de trabajo no supervisados: usa traecn_run_unattended_workflow en public; usa herramientas directas de Solo/comprobación/limpieza solo desde el perfil que las expone.
  • Catálogo completo actual y notas de configuración entre agentes: lee references/mcp-surface.md al elegir una herramienta MCP exacta o configurar un cliente.

Escala de Perfiles

  • public: 20 herramientas. Úsalo para integraciones de agente publicadas por defecto.
  • ops: 32 herramientas. Úsalo para recuperación, limpieza, control de conversaciones Solo y trabajo de comprobación de cola larga.
  • full: 36 herramientas. Úsalo para auditorías, comprobaciones de compatibilidad y clientes que quieren intencionadamente todos los atajos explícitos.

Validación

  • Ejecuta node -e "console.log(require('./mcp-server').MCP_TOOLS.map(t => t.name).join('\n'))" para verificar la lista de herramientas activas desde el código.
  • Ejecuta npm run doctor para la preparación del entorno local.
  • Ejecuta npm test para la secuencia de pruebas mantenida en el repositorio después de cambios de comportamiento.
  • Ejecuta npm run acceptance:audit -- --require-complete antes de reclamar preparación para flujos de trabajo no supervisados de extremo a extremo en TraeCN.
  • Para cambios de tipo release, ejecuta npm run test:all cuando sea práctico.

Reglas de Seguridad

  • Mantén la puerta de enlace vinculada a 127.0.0.1 a menos que se requiera acceso remoto intencionadamente.
  • Nunca confirmes .env, tokens, cabeceras de autorización, datos de perfil de TraeCN en bruto, audit-logs, demo-output, logs o node_modules.
  • Prefiere superficies MCP/HTTP/CLI sobre rutas de control GUI cuando el servidor MCP pueda realizar la operación.
  • Trata el texto de diálogo de TraeCN en vivo, el estado de la puerta de enlace, el estado de limpieza y el comportamiento de la cola de modelos externos como específicos del entorno hasta que se revaliden.

Skills relacionados