TanStack MCP

Servidor MCP de nível oficial para o ecossistema TanStack. Documentação em tempo real, pesquisa e scaffolding.

Documentação

Servidor MCP TanStack

🚀 A ponte definitiva entre agentes de codificação com IA e o ecossistema TanStack.

Um servidor Model Context Protocol (MCP) de nível oficial que traz todo o poder da CLI TanStack diretamente para o seu assistente de IA. Ele permite que sua IA pesquise documentação oficial, descubra bibliotecas, busque guias e crie novos projetos—tudo sem sair do chat.

🌟 Recursos Principais

Pesquisa de Documentação Sem Chave: Pesquise a documentação oficial do TanStack (backend Algolia) sem precisar de chaves de API.
Guias em Texto Completo: Obtenha conteúdo Markdown em tempo real de qualquer página do ecossistema.
Criação de Projetos: Crie novos aplicativos TanStack Start com comandos assistidos por IA.
Descoberta do Ecossistema: Liste mais de 16 bibliotecas, parceiros do ecossistema (hospedagem, autenticação, banco de dados) e informações de versão.
Poder da CLI: Acesso direto a ferramentas de criação, complementos e fixação de versões.

🛠️ Referência de Ferramentas

Ferramenta	Finalidade
`search_tanstack_docs`	Pesquise a documentação oficial do TanStack com filtros de consulta, biblioteca e framework.
`fetch_tanstack_doc`	Recupere o conteúdo Markdown completo de uma página de documentação (ex.: `router`, `guide/file-based-routing`).
`list_tanstack_libraries`	Descubra todas as bibliotecas oficiais do TanStack (Query, Router, Table, Form, etc.).
`list_tanstack_ecosystem`	Encontre parceiros para hospedagem, autenticação, bancos de dados e muito mais.
`create_tanstack_project`	Inicie um novo projeto TanStack Start com configurações personalizadas de complementos.
`add_tanstack_addon`	Instale complementos (Tailwind, Clerk, etc.) em um projeto existente.
`pin_tanstack_versions`	Fixe todas as versões das bibliotecas TanStack no seu `package.json` para estabilidade.

💻 Configuração

Você pode executar o servidor usando npx ou Docker.

Método 1: NPX (Recomendado)

Adicione isto ao seu arquivo de configurações MCP:

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

  }
}

Método 2: Docker

Requisitos: Docker Desktop deve estar em execução.

{
  "mcpServers": {
    "tanstack": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "gihan92/tanstack-mcp:latest"
      ]
    }
  }
}

🚀 Desenvolvimento Local

Para contribuir ou testar o servidor localmente:

Clone o repositório:

git clone https://github.com/your-username/tanstack-mcp.git
cd tanstack-mcp

Instale as dependências:
```
pnpm install
```
Execute em modo de desenvolvimento:
```
pnpm dev
```
Compile para produção:
```
pnpm build
```

📝 Créditos e Licença

Este servidor é um wrapper em torno do @tanstack/cli oficial. Toda a documentação e dados das bibliotecas são propriedade da TanStack.

Autor: gihan92