Correa MCP
Un servidor MCP para Strapi CMS, que proporciona acceso a tipos de contenido y entradas a través del Protocolo de contexto de modelo.
Descripción general
Este servidor MCP se integra con cualquier instancia de Strapi CMS para proporcionar:
- Acceso a los tipos de contenido de Strapi como recursos
- Herramientas para crear y actualizar tipos de contenido en Strapi
- Herramientas para gestionar entradas de contenido (crear, leer, actualizar, eliminar)
- Soporte para Strapi en modo de desarrollo
Configuración
Variables de entorno
Se recomienda utilizar un archivo .env
en la raíz del proyecto para almacenar sus credenciales.
STRAPI_URL
: La URL de su instancia de Strapi (predeterminado:http://localhost:1337
)STRAPI_ADMIN_EMAIL
: La dirección de correo electrónico de un usuario administrador de Strapi (recomendado para funcionalidad completa, especialmente acceso al esquema).STRAPI_ADMIN_PASSWORD
: La contraseña para el usuario administrador de Strapi (recomendado).STRAPI_API_TOKEN
: (Respaldo opcional) Un token de API. Se puede usar si no se proporcionan credenciales de administrador, pero puede tener permisos limitados.STRAPI_DEV_MODE
: Establezca en"true"
para habilitar las funciones del modo de desarrollo (el valor predeterminado esfalse
).
Ejemplo de archivo .env
:
Importante: agregue .env
a su archivo .gitignore
para evitar confirmar las credenciales.
Instalación
Correr
Método recomendado (usando archivo .env
):
Asegúrate de haber compilado el proyecto ( npm run build
). Luego, ejecuta el servidor con Node.js v20.6.0+ y el parámetro --env-file
:
Alternativa (utilizando variables de entorno directamente):
Características
- Enumerar y leer tipos de contenido
- Obtener, crear, actualizar y eliminar entradas
- Subir archivos multimedia
- Conectar y desconectar relaciones
- Obtener esquemas de tipos de contenido
Registro de cambios
0.1.6
- Se agregó la herramienta
create_content_type
: permite crear nuevos tipos de contenido a través de la API Content-Type Builder (requiere credenciales de administrador). - Credenciales de administrador priorizadas: se actualizó la lógica para preferir el correo electrónico y la contraseña del administrador para obtener tipos de contenido y esquemas, lo que mejora la confiabilidad.
- Documentación actualizada: se aclararon los métodos de autenticación y se recomendaron procedimientos de ejecución.
0.1.5
- Descubrimiento mejorado de tipos de contenido con múltiples métodos de respaldo
- Se agregó un manejo y registro de errores más robusto
- Inferencia de esquemas mejorada para tipos de contenido
0.1.4
- Manejo de errores mejorado con códigos de error más específicos
- Se agregaron los códigos de error
ResourceNotFound
yAccessDenied
- Mejores mensajes de error para errores comunes de API
0.1.3
- Lanzamiento público inicial
Licencia
Instituto Tecnológico de Massachusetts (MIT)
Servidor MCP strapi-mcp
Un servidor MCP para su Strapi CMS
Este es un servidor MCP basado en TypeScript que se integra con Strapi CMS. Proporciona acceso a los tipos de contenido y entradas de Strapi mediante el protocolo MCP, lo que permite:
- Acceda a los tipos de contenido de Strapi como recursos
- Crear, leer, actualizar y eliminar entradas de contenido
- Gestiona tu contenido de Strapi a través de las herramientas MCP
Características
Recursos
- Enumere y acceda a los tipos de contenido mediante las URI
strapi://content-type/
- Cada tipo de contenido expone sus entradas como JSON
- Tipo MIME de aplicación/JSON para acceso a contenido estructurado
Herramientas
list_content_types
: enumera todos los tipos de contenido disponibles en Strapiget_entries
: obtiene entradas para un tipo de contenido específico con filtrado, paginación, ordenamiento y población de relaciones opcionalesget_entry
- Obtener una entrada específica por IDcreate_entry
- Crea una nueva entrada para un tipo de contenidoupdate_entry
- Actualizar una entrada existentedelete_entry
- Eliminar una entradaupload_media
- Sube un archivo multimedia a Strapiget_content_type_schema
: obtiene el esquema (campos, tipos, relaciones) para un tipo de contenido específico.connect_relation
- Conecta entradas relacionadas al campo de relación de una entrada.disconnect_relation
- Desconectar entradas relacionadas del campo de relación de una entrada.create_content_type
: crea un nuevo tipo de contenido utilizando la API Content-Type Builder (requiere privilegios de administrador).
Funciones avanzadas
Filtrado, paginación y ordenación
La herramienta get_entries
admite opciones de consulta avanzadas:
URI de recursos
Se puede acceder a los recursos con varios formatos de URI:
strapi://content-type/api::article.article
- Obtener todos los artículosstrapi://content-type/api::article.article/1
- Obtener el artículo con ID 1strapi://content-type/api::article.article?filters={"title":{"$contains":"hello"}}
- Obtener artículos filtrados
Desarrollo
Instalar dependencias:
Construir el servidor:
Para desarrollo con reconstrucción automática:
Instalación
Para obtener instrucciones detalladas paso a paso sobre cómo implementar y probar este servidor MCP, consulte el archivo DEPLOYMENT.md .
Configuración rápida:
- Construya el servidor:
npm run build
- Configure su instancia de Strapi y obtenga un token API
- Agregue la configuración del servidor a Claude Desktop:
En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
En Windows: %APPDATA%/Claude/claude_desktop_config.json
Variables de entorno
STRAPI_URL
(opcional): la URL de su instancia de Strapi (el valor predeterminado es http://localhost:1337 )STRAPI_ADMIN_EMAIL
ySTRAPI_ADMIN_PASSWORD
(Recomendado): Credenciales de un usuario administrador de Strapi. Necesarias para funcionalidades completas, como la obtención de esquemas de tipos de contenido.STRAPI_API_TOKEN
(Respaldo opcional): Su token de la API de Strapi. Puede usarse si no se proporcionan credenciales de administrador, pero la funcionalidad podría estar limitada según los permisos del token.STRAPI_DEV_MODE
(opcional): Establézcalo en "verdadero" para habilitar las funciones del modo de desarrollo (el valor predeterminado es falso)
Prioridad de autenticación
El servidor prioriza los métodos de autenticación en este orden:
- Correo electrónico y contraseña de administrador (
STRAPI_ADMIN_EMAIL
,STRAPI_ADMIN_PASSWORD
) - Token API (
STRAPI_API_TOKEN
)
Se recomienda encarecidamente utilizar credenciales de administrador para obtener los mejores resultados.
Obtención de credenciales Strapi
- Credenciales de administrador: utilice el correo electrónico y la contraseña de un superadministrador existente o cree un usuario administrador dedicado en su panel de administración de Strapi (Configuración > Panel de administración > Usuarios).
- Token de API: (Respaldo opcional)
- Inicie sesión en su panel de administración de Strapi
- Vaya a Configuración > Tokens API
- Haga clic en "Crear nuevo token de API".
- Establezca un nombre, una descripción y un tipo de token (preferiblemente "Acceso completo")
- Copia el token generado y úsalo en la configuración de tu servidor MCP
Depuración
Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:
El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.
Ejemplos de uso
Una vez configurado y en funcionamiento el servidor MCP, puede usarlo con Claude para interactuar con su CMS Strapi. Aquí tiene algunos ejemplos:
Listado de tipos de contenido
Obtener entradas
Creando una entrada
Carga de medios
Conectando relaciones
Desconectando relaciones
Creación de un tipo de contenido
Actualizar un tipo de contenido
Acceso a recursos
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Proporciona acceso al contenido de Strapi CMS a través del protocolo MCP, lo que permite a los usuarios crear, leer, actualizar y eliminar entradas de contenido a través de Claude.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Strapi CMS instances through a standardized interface, supporting content types and REST API operations.Last updated -56520JavaScriptMIT License
- -securityAlicense-qualityAn MCP server that allows accessing and managing ledger files through Claude by providing account listing, balance checking, and transaction register viewing capabilities.Last updated -1PythonGPL 3.0
- AsecurityAlicenseAqualityAn MCP server that enables Claude to interact with Twitter, allowing for posting tweets and searching Twitter content.Last updated -2108195TypeScriptMIT License
- AsecurityFlicenseAqualityAn MCP server that integrates Claude with Anki flashcards, allowing users to review due cards and create new flashcards directly through conversation.Last updated -68Python