Chatpack MCP

@chatpack/mcp

Um servidor MCP somente leitura para agentes de codificação que integram o Chatpack. Ele inclui a documentação do repositório, a referência autoritativa llms.txt, guias de framework, e o código-fonte da UI React. Ele roda localmente via stdio e requer Node.js 20 ou superior.

O servidor usa conteúdo empacotado e não faz requisições de rede. Cada resposta inclui um hash do snapshot do conteúdo e as versões dos pacotes representadas pelo snapshot. Compare essas versões com seus pacotes Chatpack instalados. Para um pacote instalado, seu próprio llms.txt permanece como a referência autoritativa.

Conectar

Após este pacote ser publicado, adicione-o à configuração de servidor do seu cliente MCP:

{
  "mcpServers": {
    "chatpack": {
      "command": "npx",
      "args": ["-y", "@chatpack/mcp"]
    }
  }
}

A localização exata da configuração depende do seu cliente. Fixe a versão do pacote MCP quando precisar de um snapshot de documentação reproduzível.

Para testá-lo a partir deste repositório antes da publicação:

pnpm install
pnpm --filter @chatpack/mcp build

Defina o comando do seu cliente como node e seus argumentos como o caminho absoluto de packages/mcp/dist/cli.js. O processo reserva o stdout para mensagens MCP.

Ferramentas

Ferramenta	Entrada	Resultado
search_docs	query, opcional limit (1–20, padrão 5)	IDs de documentos correspondentes, links e trechos
get_document	id	Documento completo; llms retorna a referência de integração
get_integration_guide	framework	Guia de configuração do framework, guia de autenticação e referência de integração
list_ui_blocks	Nenhum	Exportações públicas de runtime de @chatpack/ui
get_ui_block	name, opcional includeSupportingFiles	Módulo de origem, código-fonte da UI de suporte, folha de estilo e guia de uso

Valores de framework suportados: nextjs, express, hono, elysia, tanstack-start e bun-deno-workers.

O recurso chatpack://docs/llms também fornece a referência de integração. Para solução de problemas, pesquise um código de erro como UNAUTHENTICATED e depois leia o documento correspondente. O servidor retorna orientações; ele não inspeciona nem altera a configuração do seu aplicativo.

Os arquivos de origem da UI compartilham utilitários e contratos públicos de cliente. Prefira instalar @chatpack/ui e seguir o guia de uso retornado ao usar seus componentes. Defina includeSupportingFiles como true para incluir os módulos de UI do pacote e a folha de estilo ao rastrear importações. Por padrão, a resposta inclui apenas o módulo de implementação da exportação e o guia de uso.

Escopo e versões

O servidor lê apenas seu catálogo integrado. Ele não lê os arquivos do seu projeto, não executa comandos, não aceita URLs ou caminhos arbitrários, e não acessa conversas, mensagens, credenciais de autenticação ou bancos de dados.

pnpm --filter @chatpack/mcp test compila o pacote e exercita seu ponto de entrada stdio por meio de um cliente MCP. Build e prepack regeneram o catálogo a partir das fontes do repositório. Alterações na documentação empacotada ou no código-fonte da UI exigem uma nova versão do MCP para chegar aos clientes.