Servidor MCP de Contentstack

Este servidor de Protocolo de contexto de modelo (MCP) se integra con la API de gestión de contenido de Contentstack, lo que permite que los asistentes de IA como Claude interactúen con su CMS Contentstack a través de un protocolo estandarizado.

Nota: Esta es una versión preliminar de Contentstack MCP Server. Consulte la hoja de ruta para ver las próximas mejoras y funciones planificadas.

Tabla de contenido

• Características

• Instalación

• Desarrollo

• Configuración

• Integración con asistentes de IA

• Ejemplos de uso

• Hoja de ruta

• Licencia

Related MCP server: mcp-clickup

Características

Recursos disponibles

• content-types : enumera todos los tipos de contenido (URI: contentstack://content-types )

• content-type : obtiene el tipo de contenido por UID (URI: contentstack://content-type/{uid} )

• entries : Obtener entradas por tipo de contenido (URI: contentstack://entries/{content_type_uid} )

• entry : Obtener una entrada específica (URI: contentstack://entry/{content_type_uid}/{entry_uid} )

• assets : enumera todos los activos (URI: contentstack://assets )

Gestión de tipos de contenido

• Crear, actualizar y eliminar tipos de contenido

• Definir esquemas, opciones, reglas de campo y taxonomías

• Administrar campos globales

Gestión de entradas

• Crear, actualizar y eliminar entradas

• Publicar y anular la publicación de entradas en distintos entornos

• Consultar entradas con opciones de filtrado, paginación y ordenación

Gestión global de campos

• Crear y actualizar campos globales para reutilizarlos en distintos tipos de contenido

• Recuperar campos globales con opciones de paginación

Flujos de trabajo de contenido

• Flujos de trabajo de creación de contenido guiado

• Análisis de contenido y perspectivas

• Asistencia para la planificación de la migración

Instalación

Prerrequisitos

• Node.js (v16.0.0 o superior)

• Una cuenta de Contentstack

• Credenciales de API (clave de API y token de administración)

Instalación de NPM

La forma más sencilla de utilizar este servidor MCP es a través de NPM:

# Install globally
npm install -g @drossman/contentstack-mcp

# Or use directly via npx
npx @drossman/contentstack-mcp

Instalación manual

1. Clonar el repositorio:

   git clone https://github.com/darekrossman/contentstack-mcp.git
   cd contentstack-mcp

2. Instalar dependencias:

   npm install

3. Configurar variables de entorno:

   cp .env.example .env

   Edite el archivo .env con sus credenciales de Contentstack:

   CONTENTSTACK_API_KEY=your_api_key_here
   CONTENTSTACK_MANAGEMENT_TOKEN=your_management_token_here
   # Optional: Specify branch if using branches
   CONTENTSTACK_BRANCH=your_branch_name

4. Construya e inicie el servidor:

   npm run build
   npm start

Instalación a través de Smithery CLI

También puedes instalar este servidor MCP usando la CLI de Smithery :

npx @smithery/cli install contentstack-mcp --client claude

Consulte la documentación CLI de Smithery para obtener más detalles y uso avanzado.

Desarrollo

Configuración para el desarrollo

Para el desarrollo, puedes utilizar:

npm run dev

Esto inicia el servidor usando ts-node para un ciclo de desarrollo más rápido.

Calidad del código

Este proyecto utiliza Biome.js para el análisis de errores y el formateo. Proporciona un estilo de código consistente y ayuda a detectar posibles problemas de forma temprana.

Comandos disponibles

• Código de pelusa :

  npm run lint

• Pelusa y arreglo :

  npm run lint:fix

• Código de formato :

  npm run format

• Formato y corrección :

  npm run format:fix

Configuración

Autenticación

Este servidor requiere autenticación con la API de Contentstack:

Token de gestión (obligatorio) :

• Token a nivel de pila con permisos predefinidos

• Establecer mediante la variable de entorno CONTENTSTACK_MANAGEMENT_TOKEN

• Generar desde el panel de Contentstack: Configuración > Tokens > Tokens de administración

Clave API (obligatoria) :

• Clave API de pila para autenticación

• Establecer mediante la variable de entorno CONTENTSTACK_API_KEY

Soporte de sucursal

Si su cuenta de Contentstack utiliza ramas, puede especificar una rama:

CONTENTSTACK_BRANCH=develop

Integración con asistentes de IA

Claude para escritorio

Para utilizar este servidor con Claude for Desktop:

1. Edite su archivo de configuración de Claude for Desktop:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json

2. Agregue este servidor a la sección mcpServers :

   {
     "mcpServers": {
       "contentstack": {
         "command": "npx",
         "args": ["-y", "@drossman/contentstack-mcp"],
         "env": {
           "CONTENTSTACK_API_KEY": "your_api_key_here",
           "CONTENTSTACK_MANAGEMENT_TOKEN": "your_management_token_here"
         }
       }
     }
   }

3. Reiniciar Claude para escritorio

Cursor

Para utilizar este servidor con Cursor, agregue la configuración del servidor Contentstack MCP:

{
   "mcpServers": {
      "contentstack": {
      "command": "npx",
      "args": ["-y", "@drossman/contentstack-mcp"],
      "env": {
         "CONTENTSTACK_API_KEY": "your_api_key_here",
         "CONTENTSTACK_MANAGEMENT_TOKEN": "your_management_token_here",
      }
      }
   }
}

Instalar con Smithery

También puedes instalar este servidor MCP mediante la CLI de Smithery usando el cliente de tu elección:

npx -y @smithery/cli install @drossman/contentstack-mcp --client claude

Los clientes disponibles incluyen:

• claudio

• clina

• windsurf

• código roo

• ingenioso

• encuentro

• cursor

• vscode

• miembros de vscode

• Boltai

• Amazon Bedrock

• amazonq

Consulte la documentación CLI de Smithery para obtener más detalles y uso avanzado.

Hoja de ruta

• [ ] Comprensión contextual de IA mejorada : mejore el aprovisionamiento de contexto para consultas complejas

• [ ] Consultas y filtrado avanzados : admite filtrado por múltiples criterios y campos personalizados

• [ ] Automatización de flujo de trabajo y publicación : habilite acciones de flujo de trabajo de contenido impulsadas por IA

• [ ] Mejoras en la gestión de activos : agregue capacidades de manipulación directa de activos

• [ ] Soporte de operaciones masivas : Implemente operaciones por lotes para entradas y activos

• [ ] Manejo de errores mejorado y retroalimentación de IA : refine los mensajes de error para el consumo de IA

• [ ] Contexto y permisos específicos del usuario : adapte las acciones en función de los permisos del usuario

• [ ] Extensibilidad para herramientas personalizadas : crear un marco de extensión

• [ ] Manejo de eventos en tiempo real : agregue compatibilidad con webhooks para comportamientos de IA reactivos

• [ ] Documentación completa : Desarrollar guías detalladas para la interacción con IA

Grito

Agradecimientos especiales a Ivo Toby . Este proyecto y su autor están profundamente inspirados en su trabajo en este espacio.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Aviso legal: Este proyecto no está afiliado, respaldado ni respaldado por Contentstack. Es un proyecto independiente de código abierto diseñado para funcionar con la API de Contentstack.