Contentful MCP Server
用于内容富管理API的MCP(模型上下文协议)服务器。
简介
这是一个与 Contentful 内容管理 API 集成的 MCP 服务器,提供全面的内容管理功能,可与支持 MCP 的 AI 工具(如 Claude Desktop)配合使用。
快速安装
Claude Desktop 设置
您无需克隆仓库,只需编辑 Claude Desktop 配置文件:
# 编辑配置文件
vim ~/Library/Application\ Support/Claude/claude_desktop_config.json
添加以下配置:
{
"mcpServers": {
"contentful": {
"command": "npx",
"args": ["-y", "@ivotoby/contentful-management-mcp-server"],
"env": {
"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<您的CMA令牌>"
}
}
}
}
通过 Smithery 一键安装
npx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claude
主要功能
- 内容管理:完整的条目和资产CRUD操作
- 空间管理:创建、更新和管理空间与环境
- 内容类型:管理内容模型定义
- 批量操作:批量发布、取消发布和验证
- 分页支持:智能分页防止上下文溢出(每次返回最多3个项目)
配置选项
环境变量或命令行参数
CONTENTFUL_MANAGEMENT_ACCESS_TOKEN
/--management-token
:CMA令牌CONTENTFUL_HOST
/--host
:API端点(默认为 https://api.contentful.com)SPACE_ID
/--space-id
:限定操作范围到特定空间ENVIRONMENT_ID
/--environment-id
:限定操作范围到特定环境
应用身份验证(可选)
{
"args": [
"--app-id", "<应用ID>",
"--private-key", "<私钥>",
"--space-id", "<空间ID>",
"--environment-id", "<环境ID>"
]
}
可用工具概览
- 条目管理:search_entries, create_entry, get_entry, update_entry, delete_entry...
- 资产管理:list_assets, upload_asset, get_asset, update_asset, publish_asset...
- 批量操作:bulk_publish, bulk_unpublish, bulk_validate
- 空间与环境:list_spaces, get_space, list_environments, create_environment...
- 内容类型:list_content_types, get_content_type, create_content_type...
开发调试
# 启动检查器
npm run inspect
# 监视模式自动重启
npm run inspect:watch
# 开发模式(文件变更时重新构建)
npm run dev
访问 http://localhost:5173 打开检查器界面测试和调试工具。