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
Debuggen
Der MCP Inspector bietet eine Weboberfläche zum Debuggen:
Besuchen Sie die angegebene URL, um auf die Debugging-Tools zuzugreifen.
Ressourcen
Sicherheitsüberprüfungen
Lizenz
MIT
