有内容的 MCP 服务器
A 类 示范背景协议(MCP) 为 AI 助手提供全面工具与之互动的服务器 内容 APIs (英语).
示例使用案例
这个MCP服务器为内容管理提供了一整套工具,允许AI帮助您直接在Contentful内创建,编辑,组织和发布内容. 配置后,您可以在所选的AI助手中使用自然语言来管理和与您的内容空间互动,包括:
- 内容创建:"为我们秋季产品发布创造出新的博客文章"
- 内容管理:"更新所有产品条目以包括新的定价结构"
- 资产组织:"通过运动装入并组织这些营销图像"
- 工作流程自动化:"创建将内容翻译为西班牙语的AI动作"
- 内容建模:"为客户评级在产品内容类型上添加一新字段"
目录
开始
先决条件
- 节点.js
- 无
- 内容丰富的账户 空间标识
- 内容管理 API 个人访问符
安装
单点安装
说明: 这需要 光标 将安装。 如果链接无效,请尝试下面的手动安装.
克劳德桌面 :
下载.dxt 配置文件 这里 从最近的发布并导入到克洛德桌面,以自动配置带有环境变量的 MCP 服务器.
从源安装
git clone https://github.com/contentful/contentful-mcp-server.git
cd contentful-mcp-server
npm install
npm run build
环境变量
| 环境变量 | 需求 | 默认值 | 说明 |
|---|---|---|---|
CONTENTFUL_MANAGEMENT_ACCESS_TOKEN | 对 | - 说吧 | 您的内容管理 API 个人访问符 |
SPACE_ID | 对 | - 说吧 | 您的内容空间 ID |
ENVIRONMENT_ID | 没有 | master | 空间内的目标环境 |
CONTENTFUL_HOST | 没有 | api.contentful.com | 内容 API 主机 |
EXPORT_BASE_DIR | 没有 | process.cwd() | 服务器控制的根目录 export_space 输出。 该工具在每个导出时创建了专门的子目录. |
NODE_ENV | 没有 | production | 要运行的节点环境 |
MAX_BULK_SIZE | 没有 | 10 | 单个批量操作工具调用中允许的最大ID数量(1–100). 封面公布/不公布/存档/不公布条目和资产。 减轻AI幻觉造成的意外大规模手术. |
ENABLE_EXO_TOOLS | 没有 | false | 选入经验管弦乐(ExO)工具. 设定为 true 登记 ExO 工具集(组件、数据组件、设计符号、经验、经验模板、经验碎片)。 还要求代币持有 exoM1 至少有一扇无障碍门——两道门必须通通. |
配置
参见您选择的如何配置 MCP 服务器的 AI 工具的文档 。 例如,见文档 光标, (中文(简体) ), VS 代码,或 克劳德桌面。 。 。 .
下面是一个样本配置:
{
"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"
}
}
}
}
可用的工具
| 类别 | 工具名称 | 说明 |
|---|---|---|
| 背景设置( S) | get_initial_context | 初始化连接并获得使用指令 |
| 内容类型 | list_content_types | 列出内容类型(每个请求最多10个) |
get_content_type | 获取详细内容类型信息 | |
create_content_type | 创建新内容类型 | |
update_content_type | 修改现有内容类型 | |
publish_content_type | 发布内容类型更改 | |
unpublish_content_type | 撤消内容类型 | |
delete_content_type | 删除内容类型 | |
| 条目 | search_entries | 搜索和过滤空间中的条目 |
get_entry | 获取特定条目 | |
get_entry_snapshot | 检索条目版本历史( snapshots) | |
create_entry | 在 locale 支持下创建新内容条目 | |
update_entry | 在本地端支持下修改已存在的条目 | |
patch_entry | 更改特定的字段地块, 而不重放其它( JSON Patch) | |
publish_entry | 公布条目(单项或批量不超过100个) | |
unpublish_entry | 撤销条目(单项或批量最多100个) | |
delete_entry | 删除条目 | |
resolve_entry_references | 递归解析条目的引用树 | |
| 编辑器接口 | list_editor_interfaces | 在空格中列出所有编辑器接口 |
get_editor_interface | 获取内容类型的编辑器界面 | |
update_editor_interface | 更新字段控件、侧边栏和布局 | |
| 资产 | upload_asset | 上传新资产 |
list_assets | 列出和浏览资产(每个请求最多3个) | |
get_asset | 收回具体资产 | |
update_asset | 修改资产元数据 | |
publish_asset | 公布资产(单独或批量最多100个) | |
unpublish_asset | 未提资产(单件或多件可达100个) | |
delete_asset | 删除资产 | |
| 空间环境( E) | list_spaces | 列出可用的空格( 每个请求最多 10个) |
get_space | 获取空间细节 | |
list_environments | 在空间中列出环境 | |
create_environment | 创造新的环境 | |
delete_environment | 删除环境 | |
| 语言 | list_locales | 列出环境中的所有位置 |
get_locale | 获取特定区域信息 | |
create_locale | 为多语种内容创建新地块 | |
update_locale | 修改现有的语言设置 | |
delete_locale | 从环境中删除本地地址 | |
| 标记 | list_tags | 在环境中列出所有标签 |
create_tag | 创建公/私可见度的新标签 | |
| 组织 | list_orgs | 用户可访问列表组织 |
get_org | 获取特定组织的详细信息 | |
| 释放 | list_releases | 清单释放(每个请求最多10个) |
get_release | 获取释放 | |
create_release | 以条目/资产创建发行 | |
update_release | 修改发布的标题和/或内容 | |
delete_release | 删除释放(及其链接的释放行动) | |
publish_release | 发布发布( 同步; 通过 get_release_action(中文(简体) ) | |
unpublish_release | 取消发布( 同步; 检查通过 get_release_action(中文(简体) ) | |
validate_release | 验证一个发布,可选择反对出版/不出版 | |
get_release_action | 检查队列释放动作的状况 | |
list_release_actions | 列出释放行动(每个请求最多10个) | |
schedule_publish_release | 计划在未来日期(或重新安排)发布 | |
schedule_unpublish_release | 计划发布到未来日期( 或重排) | |
cancel_scheduled_release | 取消预定放行(两相确认) | |
list_scheduled_actions | 列出预定行动(每件请求最多10起) | |
| AI 行动 | create_ai_action | 创建自定义的 AI 驱动工作流程 |
invoke_ai_action | Invoke AI 动作带有变量( 块支持) | |
get_ai_action_invocation | 获取 AI 动作引用细节 | |
get_ai_action | 获取 AI 动作细节和配置 | |
list_ai_actions | 在空格中列出 AI 动作( 每个请求最多 3个) | |
update_ai_action | 更新现有的 AI 动作 | |
publish_ai_action | 发布 AI 动作以供使用 | |
unpublish_ai_action | 解开 AI 动作 | |
delete_ai_action | 删除 AI 动作 | |
| 分类概念 | create_concept | 创建本地化的新分类概念 |
get_concept | 获取特定分类概念 | |
list_concepts | 列出带有过滤和分级的概念 | |
update_concept | 更新分类概念属性 | |
delete_concept | 删除分类学概念 | |
| 分类学计划 | create_concept_scheme | 创建新的分类概念方案 |
get_concept_scheme | 获取具体的概念方案 | |
list_concept_schemes | 列出带有页形的概念方案 | |
update_concept_scheme | 更新概念方案属性 | |
delete_concept_scheme | 删除概念方案 | |
| 空间迁移 | space_to_space_migration_handler | 启用/损坏空间迁移工作流程 |
space_to_space_param_collection | 收集迁移工作流程的参数 | |
export_space | 导出备案空间以进行迁移 | |
import_space | 从导出的文件导入空格 | |
| 使用量 | get_usages | 获取一个组织的汇总使用指标,可选择过滤或按空间分组 |
捐款
我们欢迎捐款! 请看我们的 贡献指南 地方发展设置和贡献指南.
* 释放
这个项目使用 Nx 发布 用于自动版本和出版。 释放基于 常规武器委员会。见 贡献指南 了解更多关于释放过程的信息.
页:1
QQ 帮助和支持
许可证和通知
这个项目根据麻省理工学院的许可证获得许可。 见 自由主义 详细情况.
它还包括麻省理工学院许可的开源组件,BSD-2-Clause,和Apache-2.0. 详情见 通知 文档.
该项目包括一个自动许可证管理系统,负责跟踪所有附属单位及其许可证。 见 采取行动 文档以获取更多信息.
行为守则
我们希望为所有参与者提供安全、包容、欢迎和无骚扰的空间和经验,而不论其性别认同和表达、性取向、残疾、外貌、社会经济地位、身体大小、族裔、国籍、经验水平、年龄、宗教(或缺失)或其他身份标志.
读读行为守则全文。 。 。 .