Contentful Delivery MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，它通过 AI 助手提供对 Contentful 的交付 API 的无缝访问。使用自然语言查询和检索内容条目、资产和内容类型。

快速开始

在你的项目中安装包：

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"

特性

• 使用自然语言查询来搜索内容
• 通过 ID 或内容类型检索条目
• 资产管理
• 访问内容类型架构
• 分页支持
• 处理富文本内容

可用工具

• query_entries - 对所有内容进行自然语言搜索
• get_entry - 通过 ID 获取特定条目
• get_entries - 带有过滤的条目列表
• get_assets - 浏览所有资产
• get_asset - 通过 ID 获取资产详情
• 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"
    }
  }
});

// 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 检查器提供了用于调试的网页界面：

npm run inspector

访问提供的 URL 以使用调试工具。

资源

• Mastra AI 文档
• Contentful API 参考
• MCP 规范

许可证

MIT