内容交付 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"
# 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 来访问调试工具。
资源
执照
麻省理工学院
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.