Contentful Delivery MCP-Server

Ein Model Context Protocol (MCP)-Server, der über KI-Assistenten nahtlosen Zugriff auf die Delivery API von Contentful bietet. Fragen Sie Inhaltseinträge, Assets und Inhaltstypen in natürlicher Sprache ab und rufen Sie sie ab.

Schnellstart

Installieren Sie das Paket in Ihrem Projekt:

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

Oder global:

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

Richten Sie Ihre Contentful-Anmeldeinformationen ein:

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

Merkmale

Abfragen in natürlicher Sprache zum Suchen von Inhalten
Abrufen von Einträgen nach ID oder Inhaltstyp
Vermögensverwaltung
Zugriff auf das Inhaltstypschema
Paginierungsunterstützung
Handhabung von Rich-Text-Inhalten

Verfügbare Tools

query_entries – Natürliche Sprachsuche über alle Inhalte hinweg
get_entry - Bestimmten Eintrag nach ID abrufen
get_entries - Einträge mit Filter auflisten
get_assets - Alle Assets durchsuchen
get_asset - Assetdetails nach ID abrufen
get_content_type - Inhaltstypschema anzeigen
get_content_types – Listet verfügbare Inhaltstypen auf

Integration mit Mastra AI

Mastra AI bietet eine nahtlose Integration mit diesem MCP-Server. So richten Sie es ein:

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");

Entwicklung

# 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