内容交付 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"
特征
- 使用自然语言查询来搜索内容
- 按 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 界面：
访问提供的 URL 来访问调试工具。
资源
执照
麻省理工学院