コンテンツフル配信MCPサーバー

AIアシスタントを介してContentfulのDelivery 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"
# Optional: Restrict content to specific content types
export CONTENTFUL_CONTENT_TYPE_IDS="blogPost,article,product"

Related MCP server: Notes MCP Server

特徴

コンテンツを検索するための自然言語クエリ
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