TRAECNclaw MCP

Pacote portátil de habilidade de agente e servidor MCP stdio para conectar agentes compatíveis com MCP à automação de desktop do TraeCN.

Documentação

Skill MCP TRAECNclaw

Gerado a partir do TRAECNclaw canônico 0.6.0 no commit 40bcf7707ed9b0ff7938aea8e511d0b87d300705.

TRAECNclaw é um servidor MCP local-first e Skill de Agente para operar o aplicativo de desktop TraeCN no Mac do usuário. Este repositório é o espelho público de distribuição: ele carrega o Skill portátil, arquivos de servidor instaláveis, proveniência e metadados de marketplace sem publicar o histórico canônico privado.

TRAECNclaw expõe a versão 5 do contrato MCP com exatamente 20 ferramentas estáveis e de intenção única. O fluxo normal do Agente é:

  1. Abra um workspace somente quando necessário.
  2. Selecione modelo ou modo somente quando necessário.
  3. Envie uma mensagem e libere o contexto do chamador.
  4. Clientes MCP legados recebem uma notificação durável; hosts modernos com 2026-07-28 podem negociar Tasks e assinar o ID exato da tarefa retornada.

Enfileiramento, espera, recuperação, perguntas rotineiras que não são comandos, propriedade de tarefas e conclusão durável permanecem gerenciados pelo gateway.

O servidor local usa stdio delimitado por nova linha, implementa MCP 2026-07-28 e permanece compatível com clientes 2025-11-25 e 2024-11-05 baseados em inicialização. A versão 5 do contrato TRAECNclaw é a versão da superfície de ferramentas, não a revisão do protocolo MCP. A extensão io.modelcontextprotocol/tasks, negociada independentemente e baseada em rascunho upstream, não adiciona ferramentas.

Instalar o servidor

Instale a versão exata por meio de um canal verificado:

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

O GitHub Release correspondente também fornece o tarball npm completo com escopo e o bundle MCPB determinístico. O pacote traecnclaw@0.3.1 sem escopo e não relacionado é histórico e não é um caminho de instalação atual.

Instalar o Skill de Agente

Instale a partir do repositório público do GitHub com a CLI aberta de Skills:

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

Ou baixe o arquivo de Skill correspondente do GitHub Release. O Skill está em .codex/skills/traecnclaw-mcp e inclui assets/mcp-client-config.json, scripts/setup-mcp.js e o lançador do servidor. Reinicie o host do Agente após instalar ou atualizar o Skill.

Use scripts/setup-mcp.js para validar a descoberta do servidor e gerar a entrada do host. O tempo de execução normal é:

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

O servidor e o gateway rodam no mesmo Mac de propriedade do usuário que o TraeCN. Containers de marketplace podem inspecionar o esquema stdio, mas um container em nuvem não pode controlar de forma transparente o TraeCN desktop local do usuário.

Os metadados preparados do Registro Oficial usam o pacote com escopo @luckycat133/traecnclaw@0.6.0 com transporte stdio local. O Smithery Local usa o bundle MCPB verificado correspondente; o formato aposentado smithery.yaml permanece ausente.

Configuração

Os padrões do gateway são TRAECN_GATEWAY_HOST=127.0.0.1 e TRAECN_GATEWAY_PORT=8788. Vínculos não-loopback exigem TRAECN_GATEWAY_TOKEN. Não há configuração de perfil de ferramenta MCP.

Canais de descoberta

O mesmo repositório público é a fonte canônica para submissões de Skill e diretório MCP. Uma listagem de diretório é confiável somente quando sua versão, transporte stdio local, requisito macOS, contagem de 20 ferramentas e comando de instalação gerado correspondem a este Release.

Canais selecionados incluem ClawHub, Glama, skills.sh, AwesomeSkills.dev, MCP.Directory, MCPB/Smithery Local e—após existir um pacote público atual—o Registro Oficial MCP e PulseMCP. Outros diretórios devem reutilizar a mesma proveniência e cópia de instalação em vez de manter forks.

Glama

glama.json e o Dockerfile raiz gerado suportam registro em diretório, verificação de mantenedor, varredura de segurança/qualidade e inspeção de esquema de ferramentas. O Dockerfile instala o Release público atual e nunca contém um token de gateway ou ponte simulada.

TRAECNclaw deve ser listado como um servidor stdio local. Não descreva um container hospedado pela Glama como uma conexão remota automática ao Mac do usuário.

Consulte SOURCE_REVISION e release-manifest.json para proveniência e prontidão do canal.