Contentful Delivery MCP

🚀 内容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 许可证。