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 Strapi
get_entries : obtiene entradas para un tipo de contenido específico con filtrado, paginación, ordenamiento y población de relaciones opcionales
get_entry - Obtener una entrada específica por ID
create_entry - Crea una nueva entrada para un tipo de contenido
update_entry - Actualizar una entrada existente
delete_entry - Eliminar una entrada
upload_media - Sube un archivo multimedia a Strapi

Funciones avanzadas

Filtrado, paginación y ordenación

La herramienta get_entries admite opciones de consulta avanzadas:

{
  "contentType": "api::article.article",
  "filters": {
    "title": {
      "$contains": "hello"
    }
  },
  "pagination": {
    "page": 1,
    "pageSize": 10
  },
  "sort": ["title:asc", "createdAt:desc"],
  "populate": ["author", "categories"]
}

URI de recursos

Se puede acceder a los recursos con varios formatos de URI:

strapi://content-type/api::article.article - Obtener todos los artículos
strapi://content-type/api::article.article/1 - Obtener el artículo con ID 1
strapi://content-type/api::article.article?filters={"title":{"$contains":"hello"}} - Obtener artículos filtrados

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

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

{
  "mcpServers": {
    "strapi-mcp": {
      "command": "/path/to/strapi-mcp/build/index.js",
      "env": {
        "STRAPI_URL": "http://localhost:1337",
        "STRAPI_API_TOKEN": "your-api-token-here",
        "STRAPI_DEV_MODE": "false"
      }
    }
  }
}

Variables de entorno

STRAPI_URL (opcional): la URL de su instancia de Strapi (el valor predeterminado es http://localhost:1337 )
STRAPI_API_TOKEN (obligatorio): Su token de API de Strapi para autenticación
STRAPI_DEV_MODE (opcional): Establézcalo en "verdadero" para habilitar las funciones del modo de desarrollo (el valor predeterminado es falso)

Obtener un token API de Strapi

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:

npm run inspector

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

use_mcp_tool(
  server_name: "strapi-mcp",
  tool_name: "list_content_types",
  arguments: {}
)

Obtener entradas

use_mcp_tool(
  server_name: "strapi-mcp",
  tool_name: "get_entries",
  arguments: {
    "contentType": "api::article.article",
    "filters": {
      "title": {
        "$contains": "hello"
      }
    },
    "pagination": {
      "page": 1,
      "pageSize": 10
    },
    "sort": ["title:asc"]
  }
)

Creando una entrada

use_mcp_tool(
  server_name: "strapi-mcp",
  tool_name: "create_entry",
  arguments: {
    "contentType": "api::article.article",
    "data": {
      "title": "My New Article",
      "content": "This is the content of my article.",
      "publishedAt": "2023-01-01T00:00:00.000Z"
    }
  }
)

Carga de medios

use_mcp_tool(
  server_name: "strapi-mcp",
  tool_name: "upload_media",
  arguments: {
    "fileData": "base64-encoded-data-here",
    "fileName": "image.jpg",
    "fileType": "image/jpeg"
  }
)

Acceso a recursos

access_mcp_resource(
  server_name: "strapi-mcp",
  uri: "strapi://content-type/api::article.article"
)

Strapi MCP Server

Integrations