项目简介

Contentful MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务,旨在将AI助手(如Cursor、VS Code Copilot Chat、Claude Desktop等)与Contentful内容管理系统(CMS)深度整合。它通过提供一套强大的工具,让AI能够理解、管理和操作Contentful中的内容类型、条目、资产、环境、区域设置、标签和AI动作等,实现内容创作、管理、自动化和建模的智能化。

主要功能点

  • 内容类型管理: AI可以创建、更新、列出、获取详细信息、发布、取消发布和删除Contentful中的内容类型。
  • 内容条目管理: 允许AI搜索、获取、创建、更新、发布、取消发布和删除Contentful中的具体内容条目。
  • 媒体资产管理: AI能够上传新的媒体资产、列出、获取详情、更新其元数据、发布、取消发布和删除资产。
  • 空间与环境操作: 支持AI列出用户有权访问的Contentful空间、获取空间详情,以及列出、创建和删除不同环境。
  • 区域设置管理: AI可以列出、获取详情、创建、更新和删除Contentful环境中的区域设置(语言-地区对)。
  • 标签管理: 提供了AI列出所有现有标签和创建新标签的能力。
  • AI动作自动化: 允许AI创建自定义的AI驱动工作流(AI Action),调用这些动作并传入变量,获取动作调用详情,管理(获取详情、列出、更新、发布、取消发布、删除)AI动作本身。

安装步骤

  1. 准备环境:

  2. 安装方式选择:

    • 一键安装 (推荐,需要安装 Cursor AI 编程助手 ): 点击此链接 Install MCP Server (如果链接不工作,请尝试手动安装)。如果您的设备已安装并运行 Cursor,它将自动引导您完成服务器的配置。

    • Claude Desktop 配置:GitHub Releases页面 下载最新版本的 '.dxt' 配置文件。然后,将该文件导入到 Claude Desktop 中,以自动配置MCP服务器并设置必要的环境变量。

    • 从源代码手动安装: 如果您希望从源代码构建和运行服务器,请按照以下步骤操作:

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

      构建完成后,您可以通过 'node build/index.js' 命令手动启动服务器,但通常建议通过MCP客户端配置来自动管理其生命周期。

服务器配置

MCP服务器是设计给 MCP 客户端(如AI助手)使用的。MCP 客户端需要知道如何启动您的 MCP 服务器并与它通信。以下是您在 MCP 客户端中配置 Contentful MCP 服务器的 JSON 格式示例。请注意,具体的配置界面和方式可能因您使用的AI工具而异,但核心参数是通用的。

{
  "mcpServers": {
    "contentful-mcp": {
      "command": "npx", // 启动MCP服务器的命令。这里使用npx来运行npm包。
      "args": ["-y", "@contentful/mcp-server"], // 传递给"command"的参数。"-y"表示自动确认,"@contentful/mcp-server"是服务器的npm包名称。
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "您的Contentful管理API个人访问令牌", // 必填:用于认证到Contentful管理API的令牌。
        "SPACE_ID": "您的Contentful空间ID", // 必填:您希望AI助手操作的Contentful空间的唯一标识符。
        "ENVIRONMENT_ID": "master", // 可选:指定Contentful环境的ID,默认为"master"环境。
        "CONTENTFUL_HOST": "api.contentful.com" // 可选:Contentful API的主机地址,默认为"api.contentful.com"。
      }
    }
  }
}

请务必将上述配置中的'您的Contentful管理API个人访问令牌'和'您的Contentful空间ID'替换为您自己的实际值。 其他环境变量通常可以保持默认设置。

基本使用方法

一旦Contentful MCP 服务器在您的AI助手环境中配置并运行,您就可以通过自然的语言指令与Contentful进行交互。AI助手会根据您的指令选择并调用服务器提供的相应工具。

示例指令:

  • 内容创作: “为我们的秋季产品发布创建一篇新的博客文章。”
  • 内容管理: “更新所有产品条目,将它们的价格结构调整为最新标准。”
  • 资产组织: “上传这些营销图片到Contentful,并根据所属营销活动进行分类和组织。”
  • 工作流自动化: “请创建一个AI动作,用于将指定的内容自动翻译成西班牙语。”
  • 内容建模: “修改产品内容类型,为其添加一个用于收集客户评分的新字段。”

信息

分类

AI与计算