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 許可證。