内容交付MCP

Name: 内容交付MCP
Author: mshaaban0

作者：mshaaban08 星标更新：2025-05-05

安装使用来源：spider==github.com

项目介绍

Contentful Delivery MCP Server

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

快速开始

在你的项目中安装包：

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("查找关于机器学习的文章");

开发

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

# 安装依赖
npm install

# 构建
npm run build

# 自动重建开发
npm run watch

# 运行检查器
npm run inspector

调试

MCP检查器提供了一个用于调试的Web界面：

npm run inspector