Contentful Delivery MCP Server

Contentful Delivery MCP サーバー

AI アシスタントを通じて、Contentful の Delivery API にシームレスにアクセスできる Model Context Protocol（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"
# Optional: Restrict content to specific content types
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";

// Initialize the MCP client
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",
      // Optional: Restrict content to specific content types
      CONTENTFUL_CONTENT_TYPE_IDS: "blogPost,article,product"
    }
  }
});

// Create an AI agent with access to Contentful
const assistant = new Agent({
  name: "Content Assistant",
  instructions: `
    You are a helpful assistant with access to our content database.
    Use the available tools to find and provide accurate information.
  `,
  model: "gpt-4",
});

// Connect and register tools
await contentfulClient.connect();
const tools = await contentfulClient.tools();
assistant.__setTools(tools);

// Example usage
const response = await assistant.chat("Find articles about machine learning");

開発

# Clone the repo
git clone https://github.com/mshaaban0/contentful-delivery-mcp-server.git

# Install dependencies
npm install

# Build
npm run build

# Development with auto-rebuild
npm run watch

# Run the inspector
npm run inspector

デバッグ

MCP Inspector は、デバッグ用のウェブインターフェースを提供します。

npm run inspector

表示された URL にアクセスすると、デバッグツールを利用できます。

リソース

• Mastra AI ドキュメント
• Contentful API リファレンス
• MCP 仕様

セキュリティ監査

ライセンス

MIT