Contentful MCP Server

基本能力

产品定位

Contentful MCP Server 是一个专门为 Contentful 内容管理 API 设计的 MCP 服务器，旨在通过 MCP 协议提供对 Contentful 内容的全面管理能力。

核心功能

• 内容管理：支持对条目和资源的完整 CRUD 操作。
• 空间管理：创建、更新和管理空间及环境。
• 内容类型管理：管理内容类型定义。
• 本地化支持：支持多语言内容管理。
• 发布控制：管理内容的发布和取消发布工作流。
• 批量操作：支持批量发布、取消发布和验证多个条目和资源。
• 智能分页：列表操作每次请求最多返回 3 个项目，以防止上下文窗口溢出，并内置分页支持。

适用场景

• 内容迁移和批量更新
• 多语言内容管理
• 内容发布工作流自动化
• 与 Claude Desktop 等工具的集成

工具列表

• 条目管理：搜索、创建、获取、更新、删除、发布和取消发布条目。
• 批量操作：批量发布、取消发布和验证多个条目和资源。
• 资源管理：列出、上传、获取、更新、删除、发布和取消发布资源。
• 空间和环境管理：列出、获取、创建和删除空间及环境。
• 内容类型管理：列出、获取、创建、更新、删除和发布内容类型。

常见问题解答

• 如何与 Claude Desktop 集成：通过编辑 claude_desktop_config.json 文件并添加 MCP 服务器配置。
• 如何设置环境变量：通过 CONTENTFUL_HOST 和 CONTENTFUL_MANAGEMENT_ACCESS_TOKEN 环境变量或命令行参数设置。
• 如何使用应用身份验证：通过 --app-id、--private-key、--space-id 和 --environment-id 参数设置。

使用教程

使用依赖

1. 创建一个 Contentful 账户 Contentful
2. 从账户设置中生成一个内容管理 API 令牌

安装教程

1. 通过 Smithery 自动安装：

npx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claude

1. 手动安装：
2. 克隆仓库并运行 npm install
3. 或直接通过 npx 使用：

npx -y @ivotoby/contentful-management-mcp-server

调试方式

1. 使用 MCP Inspector 进行开发和调试：

npm run inspect

1. 开发模式下自动重建和重载 MCP 服务器：

npm run dev

1. 打开浏览器访问 http://localhost:5173 使用 MCP Inspector 的视觉界面进行测试和调试。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。