TanStack MCP

Servidor TanStack MCP

🚀 El puente definitivo entre agentes de codificación con IA y el ecosistema TanStack.

Un servidor de Model Context Protocol (MCP) de nivel oficial que trae todo el poder de la CLI de TanStack directamente a tu asistente de IA. Permite que tu IA busque documentación oficial, descubra librerías, obtenga guías y cree nuevos proyectos, todo sin salir del chat.

---

🌟 Características principales

• Búsqueda de documentación sin claves: Busca en la documentación oficial de TanStack (backend de Algolia) sin necesidad de claves API.
• Guías de texto completo: Obtén contenido Markdown en tiempo real de cualquier página del ecosistema.
• Creación de proyectos: Crea nuevas aplicaciones TanStack Start con comandos asistidos por IA.
• Descubrimiento del ecosistema: Lista más de 16 librerías, socios del ecosistema (hosting, autenticación, bases de datos) e información de versiones.
• Potencia de la CLI: Acceso directo a herramientas de creación, complementos y fijación de versiones.

---

🛠️ Referencia de herramientas

Herramienta	Propósito
search_tanstack_docs	Busca en la documentación oficial de TanStack con filtros de consulta, librería y framework.
fetch_tanstack_doc	Recupera el contenido Markdown completo de una página de documentación (p. ej., router, guide/file-based-routing).
list_tanstack_libraries	Descubre todas las librerías oficiales de TanStack (Query, Router, Table, Form, etc.).
list_tanstack_ecosystem	Encuentra socios para hosting, autenticación, bases de datos y más.
create_tanstack_project	Inicializa un nuevo proyecto TanStack Start con configuraciones personalizadas de complementos.
add_tanstack_addon	Instala complementos (Tailwind, Clerk, etc.) en un proyecto existente.
pin_tanstack_versions	Fija todas las versiones de las librerías TanStack en tu package.json para mayor estabilidad.

---

💻 Configuración

Puedes ejecutar el servidor usando npx o Docker.

Método 1: NPX (Recomendado)

Añade esto a tu archivo de configuración de MCP:

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

  }
}

Método 2: Docker

Requisitos: Docker Desktop debe estar en ejecución.

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

---

🚀 Desarrollo local

Para contribuir o probar el servidor localmente:

1. Clona el repositorio:

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

2. Instala las dependencias:

   pnpm install
   

3. Ejecuta en modo de desarrollo:

   pnpm dev
   

4. Compila para producción:

   pnpm build
   

---

📝 Créditos y licencia

Este servidor es un envoltorio alrededor del @tanstack/cli oficial. Toda la documentación y los datos de las librerías son propiedad de TanStack.

Autor: gihan92