Contentful Delivery MCP 服务器

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

<a href="https://glama.ai/mcp/servers/v84ui258n5"> <img width="380" height="200" src="https://glama.ai/mcp/servers/v84ui258n5/badge" alt="Contentful Delivery Server MCP server" /> </a>

快速开始

在您的项目中安装该包：

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"
# 可选：将内容限制为特定的内容类型
export CONTENTFUL_CONTENT_TYPE_IDS="blogPost,article,product"

功能特性

• 使用自然语言查询来搜索内容
• 通过 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";

// 初始化 MCP 客户端
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",
      // 可选：将内容限制为特定的内容类型
      CONTENTFUL_CONTENT_TYPE_IDS: "blogPost,article,product"
    }
  }
});

// 创建一个可以访问 Contentful 的 AI 代理
const assistant = new Agent({
  name: "Content Assistant",
  instructions: `
    您是一个有用的助手，可以访问我们的内容数据库。
    使用可用的工具来查找和提供准确的信息。
  `,
  model: "gpt-4",
});

// 连接并注册工具
await contentfulClient.connect();
const tools = await contentfulClient.tools();
assistant.__setTools(tools);

// 使用示例
const response = await assistant.chat("Find articles about machine learning");

开发

# 克隆仓库
git clone https://github.com/mshaaban0/contentful-delivery-mcp-server.git

# 安装依赖
npm install

# 构建
npm run build

# 使用自动重建进行开发
npm run watch

# 运行检查器
npm run inspector

调试

MCP Inspector 提供了一个用于调试的 Web 界面：

npm run inspector

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

资源

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

许可证

MIT