# @contentful/mcp-server 中文文档

规范地址：https://npmcn.com/package/%40contentful/mcp-server/

版本：1\.24\.5
npm 元数据更新时间：2026-11-06T00:18:13.157Z
中文译文更新时间：2026-11-10T16:38:45.544Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40contentful/mcp-server
原文对照：https://npmcn.com/package/%40contentful/mcp-server/?lang=original
项目主页：https://github.com/contentful/contentful-mcp-server#readme
源码仓库：https://github.com/contentful/contentful-mcp-server

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：424 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2025-07-25T13:51:19.419Z
- 最新版本发布：2026-11-06T00:18:12.669Z
- 近 30 天下载量：38843（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：111（近 12 个月 88 个）

## 中文简介

内容性 MCP 服务器 - 内容性模式上下文协议服务器

## 安装

```sh
npm install @contentful/mcp-server
```

也可以使用：`pnpm add @contentful/mcp-server`、`yarn add @contentful/mcp-server`、`bun add @contentful/mcp-server`

## README

# 有内容的 MCP 服务器

A 类 [示范背景协议(MCP)](https://modelcontextprotocol.io/) 为 AI 助手提供全面工具与之互动的服务器 [内容](https://www.contentful.com/) APIs (英语).

## 示例使用案例

这个MCP服务器为内容管理提供了一整套工具,允许AI帮助您直接在Contentful内创建,编辑,组织和发布内容. 配置后,您可以在所选的AI助手中使用自然语言来管理和与您的内容空间互动,包括:

-   **内容创建**:"为我们秋季产品发布创造出新的博客文章"
-   **内容管理**:"更新所有产品条目以包括新的定价结构"
-   **资产组织**:"通过运动装入并组织这些营销图像"
-   **工作流程自动化**:"创建将内容翻译为西班牙语的AI动作"
-   **内容建模**:"为客户评级在产品内容类型上添加一新字段"

## 目录

-   [开始](https://npmcn.com/package/%40contentful/mcp-server/#readme--getting-started)
    -   [先决条件](https://npmcn.com/package/%40contentful/mcp-server/#readme-prerequisites)
    -   [安装](https://npmcn.com/package/%40contentful/mcp-server/#readme-installation)
    -   [环境变量](https://npmcn.com/package/%40contentful/mcp-server/#readme-environment-variables)
    -   [配置](https://npmcn.com/package/%40contentful/mcp-server/#readme-configuration)
-   [可用的工具](https://npmcn.com/package/%40contentful/mcp-server/#readme-%EF%B8%8F-available-tools)
-   [发展](https://npmcn.com/package/%40contentful/mcp-server/#readme--development)
    -   [与 MCP 检查员进行测试](https://npmcn.com/package/%40contentful/mcp-server/#readme-testing-with-mcp-inspector)
    -   [线性](https://npmcn.com/package/%40contentful/mcp-server/#readme-linting)
-   [\* 释放](https://npmcn.com/package/%40contentful/mcp-server/#readme--releases)
-   [捐款](https://npmcn.com/package/%40contentful/mcp-server/#readme--contributing)
    -   [开发设置](https://npmcn.com/package/%40contentful/mcp-server/#readme-development-setup)
-   [页:1](https://npmcn.com/package/%40contentful/mcp-server/#readme--documentation)
-   [QQ 帮助和支持](https://npmcn.com/package/%40contentful/mcp-server/#readme--help--support)
-   [许可证和通知](https://npmcn.com/package/%40contentful/mcp-server/#readme--license-and-notices)
-   [行为守则](https://npmcn.com/package/%40contentful/mcp-server/#readme-%EF%B8%8F-code-of-conduct)

## 开始

### 先决条件

-   节点.js
-   无
-   内容丰富的账户 [空间标识](https://www.contentful.com/help/spaces/find-space-id/)
-   [内容管理 API 个人访问符](https://www.contentful.com/help/token-management/personal-access-tokens/)

### 安装

#### 单点安装

[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=contentful-mcp&config=eyJjb21tYW5kIjoibnB4IC15IEBjb250ZW50ZnVsL21jcC1zZXJ2ZXIiLCJlbnYiOnsiQ09OVEVOVEZVTF9NQU5BR0VNRU5UX0FDQ0VTU19UT0tFTiI6InlvdXItQ01BLXRva2VuIiwiU1BBQ0VfSUQiOiJ5b3VyLXNwYWNlLWlkIiwiRU5WSVJPTk1FTlRfSUQiOiJtYXN0ZXIiLCJDT05URU5URlVMX0hPU1QiOiJhcGkuY29udGVudGZ1bC5jb20ifX0%3D)

_说明: 这需要 [光标](https://cursor.com/) 将安装。 如果链接无效,请尝试下面的手动安装._

**克劳德桌面 :**

下载.dxt 配置文件 [这里](https://github.com/contentful/contentful-mcp-server/releases) 从最近的发布并导入到克洛德桌面,以自动配置带有环境变量的 MCP 服务器.

#### 从源安装

```bash
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 工具的文档 。 例如,见文档 [光标](https://docs.cursor.com/context/mcp), (中文(简体) ), [VS 代码](https://code.visualstudio.com/docs/copilot/chat/mcp-servers),或 [克劳德桌面](https://modelcontextprotocol.io/quickstart/user)。 。 。 .

下面是一个样本配置:

```json
{
  "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` | 获取一个组织的汇总使用指标,可选择过滤或按空间分组 |

## 捐款

我们欢迎捐款! 请看我们的 [贡献指南](https://npmcn.com/package/%40contentful/mcp-server/CONTRIBUTING.md) 地方发展设置和贡献指南.

## \* 释放

这个项目使用 [Nx 发布](https://nx.dev/features/manage-releases) 用于自动版本和出版。 释放基于 [常规武器委员会](https://www.conventionalcommits.org/)。见 [贡献指南](https://npmcn.com/package/%40contentful/mcp-server/CONTRIBUTING.md) 了解更多关于释放过程的信息.

## 页:1

-   [示范背景协议文档](https://modelcontextprotocol.io/)
-   [内容管理 API 文档](https://www.contentful.com/developers/docs/references/content-management-api/)

## QQ 帮助和支持

-   [实质性支助资源](https://www.contentful.com/help/getting-started/how-to-get-help/)
-   [报告错误或请求特性](https://github.com/contentful/contentful-mcp-server/issues)
-   [内容丰富的社区迪斯科尔](https://www.contentful.com/discord/)

## 许可证和通知

这个项目根据麻省理工学院的许可证获得许可。 见 [自由主义](https://npmcn.com/package/%40contentful/mcp-server/LICENSE) 详细情况.

它还包括麻省理工学院许可的开源组件,BSD-2-Clause,和Apache-2.0. 详情见 [通知](https://npmcn.com/package/%40contentful/mcp-server/NOTICE) 文档.

该项目包括一个自动许可证管理系统,负责跟踪所有附属单位及其许可证。 见 [采取行动](https://npmcn.com/package/%40contentful/mcp-server/AUTOMATION-FOR-LICENSES.md) 文档以获取更多信息.

## 行为守则

我们希望为所有参与者提供安全、包容、欢迎和无骚扰的空间和经验,而不论其性别认同和表达、性取向、残疾、外貌、社会经济地位、身体大小、族裔、国籍、经验水平、年龄、宗教(或缺失)或其他身份标志.

[读读行为守则全文](https://www.contentful.com/developers/code-of-conduct/)。 。 。 .

## 常见问题

### @contentful/mcp-server 是什么？

内容性 MCP 服务器 - 内容性模式上下文协议服务器

### 如何安装 @contentful/mcp-server？

在项目目录运行 npm install @contentful/mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 contentful-mcp-server，可以用 npx contentful-mcp-server 直接运行。

### @contentful/mcp-server 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @contentful/mcp-server 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @contentful/mcp-server 可以商用吗？

@contentful/mcp-server 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @contentful/mcp-server 的下载量有多少？

根据 npm 官方下载统计，@contentful/mcp-server 在 2026/10/11 – 2026/11/09 这 30 天内被下载 38,843 次，日均约 1,295 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @contentful/mcp-server 还在维护吗？

最新版本 1\.24\.5 发布于 2026/11/06（4 天前）；至今共发布 111 个版本，其中过去 12 个月发布了 88 个；首次发布于 2025/07/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。