Сервер MCP для доставки контента
Сервер Model Context Protocol (MCP), который обеспечивает бесперебойный доступ к Contentful Delivery API через помощников AI. Запрашивайте и извлекайте записи контента, активы и типы контента, используя естественный язык.
Быстрый старт
Установите пакет в свой проект:
npm install @mshaaban0/contentful-delivery-mcp-server
Или глобально:
npm install -g @mshaaban0/contentful-delivery-mcp-server
Настройте свои учетные данные 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
Функции
Запросы на естественном языке для поиска контента
Извлечение записей по идентификатору или типу контента
Управление активами
Доступ к схеме типа контента
Поддержка пагинации
Обработка расширенного текстового контента
Доступные инструменты
query_entries — поиск на естественном языке по всему контенту
get_entry — Извлечь определенную запись по идентификатору
get_entries — Список записей с фильтрацией
get_assets - Просмотреть все активы
get_asset — Получить данные об активе по идентификатору
get_content_type — просмотр схемы типа контента
get_content_types — список доступных типов контента
Интеграция с Mastra AI
Mastra AI обеспечивает бесшовную интеграцию с этим сервером MCP. Вот как это настроить:
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");
Разработка
# 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
Отладка
MCP Inspector предоставляет веб-интерфейс для отладки:
Перейдите по предоставленному URL-адресу, чтобы получить доступ к инструментам отладки.
Ресурсы
Аудит безопасности
Лицензия
Массачусетский технологический институт
