コンテンツフル配信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
デバッグ
MCP Inspector はデバッグ用の Web インターフェースを提供します。
npm run inspector
デバッグ ツールにアクセスするには、提供された URL にアクセスしてください。
リソース
ライセンス
マサチューセッツ工科大学