项目简介
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动作本身。
安装步骤
-
准备环境:
- 确保您的设备已安装 Node.js 和配套的 npm 包管理器。
- 您需要一个有效的 Contentful 账户,并准备好以下凭据:
- 您的 Contentful Space ID。
- 一个具有足够权限的 Contentful Management API 个人访问令牌。
-
安装方式选择:
-
一键安装 (推荐,需要安装 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与计算