内容ful 交付 MCP 服务器

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

快速开始

在项目中安装包：

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

或者全局安装：

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

设置内容ful 凭证：

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

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

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

// 示例用法
const response = await assistant.chat("查找关于机器学习的文章");

开发

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

# 安装依赖项
npm install

# 构建
npm run build

# 带自动重建的开发
npm run watch

# 运行检查仪
npm run inspector

调试

MCP 检查仪提供了一个网络界面用于调试：

npm run inspector

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

资源

• Mastra AI 文档
• 内容ful API 参考
• MCP 规范

许可证

MIT