Contentful MCP Server

🚀 Contentful MCP 服务器

Contentful MCP 服务器是一个基于 模型上下文协议（MCP） 的服务器，它为 AI 助手提供了一套全面的工具，用于与 Contentful 的 API 进行交互。通过该服务器，AI 助手能够直接在 Contentful 平台上执行内容创建、编辑、组织和发布等操作，极大地提升了内容管理的效率和便捷性。

🚀 快速开始

示例用例

此 MCP 服务器为内容管理提供了一整套全面的工具，使 AI 能够直接在 Contentful 中帮助你创建、编辑、组织和发布内容。配置完成后，你可以在所选的 AI 助手中使用自然语言来管理和与你的 Contentful 空间进行交互，包括：

• 内容创建：“为我们的秋季产品发布创建一篇新的博客文章”
• 内容管理：“更新所有产品条目以包含新的定价结构”
• 资产组织：“按活动上传并组织这些营销图片”
• 工作流自动化：“创建一个将内容翻译成西班牙语的 AI 操作”
• 内容建模：“为产品内容类型添加一个新的客户评级字段”

前提条件

• Node.js
• npm
• 拥有 空间 ID 的 Contentful 账户
• Contentful 管理 API 个人访问令牌

安装

一键安装

⚠️ 重要提示

此安装方式需要安装 Cursor。如果链接无法正常工作，请尝试下面的手动安装方法。

Claude Desktop： 从 此处 的最新版本中下载 .dxt 配置文件，并将其导入到 Claude Desktop 中，以使用你的环境变量自动配置 MCP 服务器。

从源代码安装

git clone https://github.com/contentful/contentful-mcp-server.git
cd contentful-mcp-server
npm install
npm run build

环境变量

配置

有关如何配置 MCP 服务器的详细信息，请参考你所选 AI 工具的文档。例如，可以查看 Cursor、VS Code 或 Claude Desktop 的相关文档。

以下是一个示例配置：

{
  "mcpServers": {
    "contentful-mcp": {
      "command": "npx",
      "args": ["-y", "@contentful/mcp-server"],
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "your-CMA-token",
        "SPACE_ID": "your-space-id",
        "ENVIRONMENT_ID": "master",
        "CONTENTFUL_HOST": "api.contentful.com"
      }
    }
  }
}

✨ 主要特性

可用工具

🤝 贡献代码

我们欢迎大家贡献代码！请参阅我们的 贡献指南 以了解本地开发设置和贡献准则。

📦 版本发布

本项目使用 Nx Release 进行自动化版本控制和发布。版本发布基于 常规提交 自动生成。有关发布过程的更多信息，请参阅 贡献指南。

📚 详细文档

• 模型上下文协议文档
• Contentful 管理 API 文档

❓ 帮助与支持

• Contentful 支持资源
• 报告错误或请求功能
• Contentful 社区 Discord

📄 许可证

本项目采用 MIT 许可证。有关详细信息，请参阅 LICENSE。

本项目还包含根据 MIT、BSD - 2 - Clause 和 Apache 2.0 许可证授权的开源组件。有关详细信息，请参阅 NOTICE 文件。

本项目包含一个自动化许可证管理系统，用于跟踪所有依赖项及其许可证。有关更多信息，请参阅 [AUTOMATION - FOR - LICENSES](./AUTOMATION - FOR - LICENSES.md) 文件。

🛡️ 行为准则

我们致力于为所有参与者提供一个安全、包容、友好且无骚扰的空间和体验，无论其性别认同和表达、性取向、残疾状况、外貌、社会经济地位、体型、种族、国籍、经验水平、年龄、宗教信仰（或无宗教信仰）或其他身份特征如何。

[阅读我们的完整行为准则](https://www.contentful.com/developers/code - of - conduct/)。