Servidor MCP de entrega de contenido

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso sin problemas a la API de Entrega de Contentful mediante asistentes de IA. Consulta y recupera entradas de contenido, recursos y tipos de contenido mediante lenguaje natural.

Inicio rápido

Instala el paquete en tu proyecto:

npm install @mshaaban0/contentful-delivery-mcp-server

O globalmente:

npm install -g @mshaaban0/contentful-delivery-mcp-server

Configura tus credenciales de Contentful:

export CONTENTFUL_SPACE_ID="your_space_id"
export CONTENTFUL_ACCESS_TOKEN="your_access_token"
# Optional: Restrict content to specific content types
export CONTENTFUL_CONTENT_TYPE_IDS="blogPost,article,product"

Related MCP server: Notes MCP Server

Características

Consultas en lenguaje natural para buscar contenido
Recuperar entradas por ID o tipo de contenido
Gestión de activos
Acceso al esquema de tipo de contenido
Soporte de paginación
Manejo de contenido de texto enriquecido

Herramientas disponibles

query_entries : búsqueda en lenguaje natural en todo el contenido
get_entry - Obtener una entrada específica por ID
get_entries - Lista de entradas con filtrado
get_assets - Explorar todos los activos
get_asset - Obtener detalles del activo por ID
get_content_type - Ver el esquema del tipo de contenido
get_content_types - Lista de tipos de contenido disponibles

Integración con Mastra AI

Mastra AI se integra perfectamente con este servidor MCP. Aquí te explicamos cómo configurarlo:

import { MastraMCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";

// Initialize the MCP client
const contentfulClient = new MastraMCPClient({
  name: "contentful-delivery",
  server: {
    command: "npx",
    args: ["-y", "@mshaaban0/contentful-delivery-mcp-server@latest"],
    env: {
      CONTENTFUL_ACCESS_TOKEN: "your_access_token",
      CONTENTFUL_SPACE_ID: "your_space_id",
      // Optional: Restrict content to specific content types
      CONTENTFUL_CONTENT_TYPE_IDS: "blogPost,article,product"
    }
  }
});

// Create an AI agent with access to Contentful
const assistant = new Agent({
  name: "Content Assistant",
  instructions: `
    You are a helpful assistant with access to our content database.
    Use the available tools to find and provide accurate information.
  `,
  model: "gpt-4",
});

// Connect and register tools
await contentfulClient.connect();
const tools = await contentfulClient.tools();
assistant.__setTools(tools);

// Example usage
const response = await assistant.chat("Find articles about machine learning");

Desarrollo

# Clone the repo
git clone https://github.com/mshaaban0/contentful-delivery-mcp-server.git

# Install dependencies
npm install

# Build
npm run build

# Development with auto-rebuild
npm run watch

# Run the inspector
npm run inspector

Depuración

El Inspector MCP proporciona una interfaz web para la depuración:

npm run inspector

Visite la URL proporcionada para acceder a las herramientas de depuración.

Recursos

Licencia

Instituto Tecnológico de Massachusetts (MIT)

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

Need Help?

Reddit Discussion

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Contentful Delivery MCP Server