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 é:
- Abra um workspace somente quando necessário.
- Selecione modelo ou modo somente quando necessário.
- Envie uma mensagem e libere o contexto do chamador.
- Clientes MCP legados recebem uma notificação durável; hosts modernos com
2026-07-28podem 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.