TRAECNclaw MCP

Paquete de habilidad de agente portátil y servidor MCP stdio para conectar agentes compatibles con MCP a la automatización de escritorio de TraeCN.

Documentación

Skill de TRAECNclaw MCP

Generado a partir de TRAECNclaw 0.6.0 canónico en el commit 40bcf7707ed9b0ff7938aea8e511d0b87d300705.

TRAECNclaw es un servidor MCP local-first y una Skill de Agente para operar la aplicación de escritorio TraeCN en el Mac del usuario. Este repositorio es el espejo público de distribución: contiene la Skill portable, archivos de servidor instalables, procedencia y metadatos de marketplace sin publicar el historial canónico privado.

TRAECNclaw expone la versión 5 del contrato MCP con exactamente 20 herramientas estables de intención única. El flujo normal del Agente es:

  1. Abrir un espacio de trabajo solo cuando sea necesario.
  2. Seleccionar modelo o modo solo cuando sea necesario.
  3. Enviar un mensaje y liberar el contexto del llamador.
  4. Los clientes MCP heredados reciben una notificación duradera; los hosts modernos con 2026-07-28 pueden negociar Tasks y suscribirse al ID de tarea devuelto exacto.

La cola, la espera, la recuperación, las preguntas rutinarias que no son de comandos, la propiedad de tareas y la finalización duradera permanecen gestionadas por la puerta de enlace.

El servidor local usa stdio delimitado por nuevas líneas, implementa MCP 2026-07-28 y sigue siendo compatible con clientes basados en inicialización 2025-11-25 y 2024-11-05. La versión 5 del contrato TRAECNclaw es la versión de la superficie de herramientas, no la revisión del protocolo MCP. La extensión io.modelcontextprotocol/tasks negociada de forma independiente (borrador upstream) no añade herramientas.

Instalar el servidor

Instale la versión exacta a través de un canal verificado:

npm install --global @luckycat133/traecnclaw@0.6.0
# or, after `brew info` reports 0.6.0
brew install Luckycat133/tap/traecnclaw

El Release de GitHub correspondiente también proporciona el tarball npm completo con ámbito y el paquete MCPB determinista. El paquete traecnclaw@0.3.1 sin ámbito, no relacionado, es histórico y no es una ruta de instalación actual.

Instalar la Skill de Agente

Instale desde el repositorio público de GitHub con la CLI abierta de Skills:

npx skills add https://github.com/Luckycat133/traecnclaw-mcp-skill \
  --skill traecnclaw-mcp \
  -g

O descargue el archivo de Skill correspondiente desde el Release de GitHub. La Skill se encuentra en .codex/skills/traecnclaw-mcp e incluye assets/mcp-client-config.json, scripts/setup-mcp.js y el lanzador del servidor. Reinicie el host del Agente después de instalar o actualizar la Skill.

Use scripts/setup-mcp.js para validar el descubrimiento del servidor y generar la entrada del host. El tiempo de ejecución normal es:

Agent host -> local stdio server -> gateway on the same Mac -> TraeCN

El servidor y la puerta de enlace se ejecutan en el mismo Mac propiedad del usuario que TraeCN. Los contenedores de Marketplace pueden inspeccionar el esquema stdio, pero un contenedor en la nube no puede controlar de forma transparente el escritorio local de TraeCN del usuario.

Los metadatos preparados del Registro Oficial usan el paquete con ámbito @luckycat133/traecnclaw@0.6.0 con transporte stdio local. Smithery Local usa el paquete MCPB verificado correspondiente; el formato retirado smithery.yaml sigue ausente.

Configuración

Los valores predeterminados de la puerta de enlace son TRAECN_GATEWAY_HOST=127.0.0.1 y TRAECN_GATEWAY_PORT=8788. Los enlaces que no sean de bucle local requieren TRAECN_GATEWAY_TOKEN. No hay configuración de perfil de herramientas MCP.

Canales de descubrimiento

El mismo repositorio público es la fuente canónica para los envíos al directorio de Skills y MCP. Un listado de directorio es confiable solo cuando su versión, transporte stdio local, requisito de macOS, recuento de 20 herramientas y comando de instalación generado coinciden con este Release.

Los canales seleccionados incluyen ClawHub, Glama, skills.sh, AwesomeSkills.dev, MCP.Directory, MCPB/Smithery Local y—después de que exista un paquete público actual—el Registro Oficial de MCP y PulseMCP. Otros directorios deberían reutilizar la misma procedencia y copia de instalación en lugar de mantener bifurcaciones.

Glama

glama.json y el Dockerfile raíz generado admiten el registro en el directorio, la verificación del mantenedor, el escaneo de seguridad/calidad y la inspección del esquema de herramientas. El Dockerfile instala el Release público actual y nunca contiene un token de puerta de enlace ni un puente simulado.

TRAECNclaw debe listarse como un servidor stdio local. No describa un contenedor alojado en Glama como una conexión remota automática al Mac del usuario.

Consulte SOURCE_REVISION y release-manifest.json para la procedencia y la preparación del canal.