Contentful Delivery MCP

🚀 内容ful 交付 MCP サーバー

このモデルコンテキストプロトコル (MCP) サーバーは、AIアシスタントを通じて、contentful デリバリーAPIへのシームレスなアクセスを提供します。自然言語でクエリを行い、コンテンツエントリ、アセット、コンテンツタイプを検索できます。

🚀 クイックスタート

プロジェクトにパッケージをインストールするには、以下のコマンドを実行します。

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

// コンテンツデータベースにアクセスできる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インスペクターは、デバッグ用のWebインターフェースを提供します。

npm run inspector

提供されたURLにアクセスして、デバッグツールを利用します。

📚 リソース

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

📄 ライセンス

MIT