remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides seamless access to Contentful's Delivery API through AI assistants. Allows querying and retrieving content entries, assets, and content types using natural language.

コンテンツフル配信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"

特徴

コンテンツを検索するための自然言語クエリ
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 はデバッグ用の Web インターフェースを提供します。

npm run inspector

デバッグツールにアクセスするには、提供された URL にアクセスしてください。

リソース

ライセンス

マサチューセッツ工科大学

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Contentful の Delivery API と対話する TypeScript ベースの MCP サーバー。これにより、ユーザーは自然言語を使用してテキストノートを作成、クエリ、要約できます。

Related Resources

Reddit Discussion about this server

Contentful Delivery MCP Server