MCP Strapi Server

Un servidor Model Context Protocol (MCP) para operaciones CRUD en Strapi, permitiendo interactuar con cualquier content type de Strapi a través de herramientas estandarizadas.

Características

• ✅ 13 Herramientas para operaciones CRUD, gestión de contenidos y medios

• ✅ Sistema genérico - funciona con cualquier content type

• ✅ Fetch nativo - sin dependencias adicionales (Node.js 22+)

• ✅ Stdio transport - integración local con Claude Desktop

• ✅ TypeScript moderno - tipado completo y seguro

• ✅ Gestión de medios - búsqueda, obtención y carga de archivos

• ✅ i18n support - soporte completo para internacionalización

Requisitos

• Node.js 22+ (para soporte nativo de fetch)

• Strapi corriendo en localhost:1337 (o configurado en STRAPI_URL)

Instalación

Opción 1: Desarrollo Local

Opción 2: Desarrollo con Watch Mode

Configuración en Claude Desktop

Añade el servidor MCP a tu configuración de Claude Desktop:

⚠️ Notas Importantes sobre Content Types

Uso del parámetro contentType

Para las operaciones CRUD (create, read, list, update, delete), SIEMPRE debes usar el nombre PLURAL del content type:

✅ CORRECTO:

• "products"

• "articles"

• "categories"

• "profiles"

❌ INCORRECTO:

• "api::product.product" (UID completo)

• "product" (singular)

• "Product" (capitalizado)

Cómo obtener el nombre correcto

1. Usa la herramienta strapi-list-content-types para ver todos los content types disponibles

2. En la respuesta, busca el campo pluralName - ese es el valor que debes usar

3. Ejemplo de respuesta:

Excepciones

La herramienta strapi-add-field es la ÚNICA que requiere el UID completo:

• ✅ "api::product.product" para strapi-add-field

• ❌ "products" NO funciona con strapi-add-field

Herramientas Disponibles (13 total)

CRUD Operations (6 tools)

1. strapi-create

Crea una nueva entrada en un content type.

Parámetros:

• contentType (string): Nombre PLURAL del content type (ej: "articles", "products")

• data (object): Datos de la entrada

• populate (string[], opcional): Relaciones a poblar

Ejemplo:

⚠️ IMPORTANTE: Usa el nombre plural del content type ("articles"), NO el UID completo ("api::article.article").

2. strapi-read

Lee una entrada específica por ID o documentId.

Parámetros:

• contentType (string): Nombre PLURAL del content type (ej: "articles")

• id (string | number): ID numérico o documentId (string) de la entrada

• fields (string[], opcional): Campos a retornar

• populate (string[], opcional): Relaciones a poblar

Ejemplo:

💡 Nota: En Strapi v5, el parámetro id acepta tanto IDs numéricos como documentIds (strings).

3. strapi-list

Lista entradas con filtrado, paginación y ordenamiento.

Parámetros:

• contentType (string): Nombre PLURAL del content type (ej: "articles")

• filters (object, opcional): Filtros de búsqueda

• sort (string[], opcional): Campos de ordenamiento

• pagination (object, opcional): Configuración de paginación

• fields (string[], opcional): Campos a retornar

• populate (string[], opcional): Relaciones a poblar

Ejemplo:

4. strapi-update

Actualiza una entrada existente (actualización parcial).

Parámetros:

• contentType (string): Nombre PLURAL del content type (ej: "articles")

• id (string | number): ID numérico o documentId (string) de la entrada

• data (object): Datos a actualizar (solo los campos que quieres cambiar)

• populate (string[], opcional): Relaciones a poblar

Ejemplo:

5. strapi-delete

Elimina una entrada.

Parámetros:

• contentType (string): Nombre PLURAL del content type (ej: "articles")

• id (string | number): ID numérico o documentId (string) de la entrada a eliminar

Ejemplo:

⚠️ Nota: Puede aparecer un error de "JSON input" después de eliminar, pero la entrada SÍ se elimina correctamente. Esto ocurre porque Strapi retorna una respuesta vacía.

Content Type Management (3 tools)

• strapi-list-content-types - Listar todos los content types disponibles

• strapi-get-schema - Obtener schema detallado de un content type

• strapi-add-field - Añadir campo a un content type

Internationalization (1 tool)

• strapi-get-i18n-locales - Obtener locales disponibles

Media Management (3 tools)

• strapi-search-media - Buscar archivos en la biblioteca de medios

• strapi-get-media - Obtener archivo específico por ID

• strapi-upload-media - Subir archivo a la biblioteca de medios

Ejemplos de Uso con Content Types Personalizados

Productos

Perfiles de Usuario

Estructura del Proyecto

Variables de Entorno

Debugging

Los logs se escriben a stderr para no interferir con el protocolo MCP (que usa stdout):

Características implementadas

• ✅ Autenticación con API Tokens de Strapi

• ✅ Validación de i18n con detección de idiomas heredados

• ✅ 13 herramientas completas (CRUD, Content Types, Medios, i18n)

• ✅ Soporte para localizaciones múltiples

• ✅ Gestión completa de medios (búsqueda, descarga, carga)

• ✅ Documentación exhaustiva en CLAUDE.md

• ✅ Strict mode para validaciones de contenido

Solución de Problemas

Error: "Node.js 22+ required"

Asegúrate de tener Node.js 22 o superior instalado:

Error de conexión a Strapi

Verifica que Strapi esté corriendo y accesible:

Licencia

MIT

Contribuciones

Las contribuciones son bienvenidas. Por favor:

1. Fork el repositorio

2. Crea una rama para tu feature (git checkout -b feature/amazing-feature)

3. Commit tus cambios (git commit -m 'Add amazing feature')

4. Push a la rama (git push origin feature/amazing-feature)

5. Abre un Pull Request

Autor

Creado con las mejores prácticas de MCP TypeScript SDK y Strapi Entity Service API.