STARWARCLOUD STARWAR.AI
返回市场
内容填充MCP

内容填充MCP

作者：ivo-toby61 星标更新：2025-10-09
安装使用来源：spider==github.com

项目介绍

<img width="700" src="https://images.ctfassets.net/jtqsy5pye0zd/6wNuQ2xMvbw134rccObi0q/bf61badc6d6d9780609e541713f0bba6/Contentful_Logo_2.5_Dark.svg?w=700&q=100" alt="Contentful MCP server"/>

Contentful MCP Server

通知

这是一个由社区驱动的服务器！Contentful 已经发布了一个官方服务器，你可以在这里找到：这里

smithery 徽章

一个与 Contentful 内容管理 API 集成的 MCP 服务器实现，提供全面的内容管理能力。

  • 请注意；如果你对代码不感兴趣，只是想在 Claude Desktop（或其他能够使用 MCP 服务器的工具）中使用这个 MCP，你不需要克隆这个仓库，你可以在 Claude desktop 中设置它，参考“在 Claude Desktop 中使用”部分获取安装说明。

<a href="https://glama.ai/mcp/servers/l2fxeaot4p"><img width="380" height="200" src="https://gips2.baidu.com/it/u=840392128,22889206&fm=3081&app=3081&f=PNG?w=760&h=400" alt="contentful-mcp MCP server" /></a>

功能

  • 内容管理：条目和资产的完整 CRUD 操作
  • 评论管理：创建、检索并管理条目的评论，支持纯文本和富文本格式，包括线程对话
  • 空间管理：创建、更新和管理空间及环境
  • 内容类型：管理内容类型定义
  • 本地化：支持多种语言
  • 发布：控制内容发布工作流
  • 批量操作：执行批量发布、取消发布和验证多个条目和资产
  • 智能分页：列表操作每次请求最多返回 3 个项目以防止上下文窗口溢出，并内置分页支持

分页

为了防止大模型中的上下文窗口溢出，列表操作（如 search_entries 和 list_assets）限制每次请求返回 3 个项目。每个响应包括：

  • 可用项目的总数
  • 当前页面的项目（最多 3 个）
  • 剩余项目的数量
  • 下一页的跳过值
  • 提示大模型提供更多项目的消息

此分页系统允许大模型高效处理大数据集，同时保持上下文窗口限制。

批量操作

批量操作功能提供了同时管理多个内容项的有效方式：

  • 异步处理：操作异步运行并提供状态更新
  • 高效内容管理：通过单个 API 调用处理多个条目或资产
  • 状态跟踪：监控进度，包括成功和失败的数量
  • 资源优化：减少 API 调用，提高批处理操作性能

这些批量操作工具非常适合内容迁移、批量更新或批量发布工作流。

工具

条目管理

  • search_entries：使用查询参数搜索条目
  • create_entry：创建新条目
  • get_entry：检索现有条目
  • update_entry：更新条目字段
  • delete_entry：删除条目
  • publish_entry：发布条目
  • unpublish_entry：取消发布条目

评论管理

  • get_comments：根据状态（活动、已解决、全部）过滤检索条目的评论
  • create_comment：在条目上创建新评论，支持纯文本和富文本格式。通过提供父评论 ID 回复现有评论来支持线程对话
  • get_single_comment：通过其 ID 检索特定条目的评论
  • delete_comment：从条目中删除特定评论
  • update_comment：更新现有评论的新正文内容或状态更改

线程评论

评论支持线程功能，以实现结构化的对话并绕过 512 字符限制：

  • 回复评论：在 create_comment 中使用 parent 参数回复现有评论
  • 线程对话：通过回复特定评论构建对话树
  • 扩展讨论：通过创建线程回复继续更长的消息，绕过 512 字符限制
  • 对话上下文：通过组织相关评论在线程中维护讨论上下文

示例用法：

  1. 创建主要评论：create_comment 使用 entryId、body 和 status
  2. 回复该评论：create_comment 使用 entryId、body、status 和 parent（你回复的评论的 ID）
  3. 继续线程：通过使用其 ID 作为 parent 回复线程中的任何评论

批量操作

  • bulk_publish：在一个操作中发布多个条目和资产。接受实体数组（条目和资产），并将它们的发布作为批次处理。
  • bulk_unpublish：在一个操作中取消发布多个条目和资产。类似于 bulk_publish，但将内容从交付 API 中移除。
  • bulk_validate：验证多个条目的一致性、引用和必填字段。返回验证结果而不修改内容。

资产管理

  • list_assets：分页列出资产（每页 3 个项目）
  • upload_asset：上传带有元数据的新资产
  • get_asset：检索资产详情和信息
  • update_asset：更新资产元数据和文件
  • delete_asset：从空间中删除资产
  • publish_asset：将资产发布到交付 API
  • unpublish_asset：从交付 API 中取消发布资产

空间及环境管理

  • list_spaces：列出可用空间
  • get_space：获取空间详情
  • list_environments：列出空间中的环境
  • create_environment：创建新环境
  • delete_environment：删除环境

内容类型管理

  • list_content_types：列出可用内容类型
  • get_content_type：获取内容类型详情
  • create_content_type：创建新内容类型
  • update_content_type：更新内容类型
  • delete_content_type：删除内容类型
  • publish_content_type：发布内容类型

开发工具

MCP Inspector

该项目包含一个 MCP Inspector 工具，有助于开发和调试：

  • 检查模式：运行 npm run inspect 启动检查器，你可以通过访问 http://localhost:5173 打开检查器
  • 监视模式：使用 npm run inspect:watch 在文件更改时自动重启检查器
  • 可视化界面：检查器提供一个 Web 界面来测试和调试 MCP 工具
  • 实时测试：尝试工具并立即查看响应
  • 批量操作测试：测试和监控批量操作，具有进度和结果的视觉反馈

项目还包含一个 npm run dev 命令，该命令会在每次更改时重建和重新加载 MCP 服务器。

配置

先决条件

  1. 在 Contentful 创建一个账户
  2. 从你的账户设置生成一个内容管理 API 令牌

环境变量

这些变量也可以作为参数设置

  • CONTENTFUL_HOST / --host：Contentful 管理 API 端点（默认为 https://api.contentful.com）
  • CONTENTFUL_MANAGEMENT_ACCESS_TOKEN / --management-token：你的内容管理 API 令牌
  • ENABLE_HTTP_SERVER / --http：设置为 "true" 以启用 HTTP/SSE 模式
  • HTTP_PORT / --port：HTTP 服务器端口（默认：3000）
  • HTTP_HOST / --http-host：HTTP 服务器主机（默认：localhost）

空间和环境范围

你可以设置 spaceId 和 EnvironmentId，确保 LLM 只在定义的空间/环境 ID 上进行操作。 这主要是为了支持在特定空间内操作的代理。如果同时设置了 SPACE_ID 和 ENVIRONMENT_ID 环境变量， 工具将不会报告需要这些值，并且处理器将使用环境变量进行 CMA 操作。 你也将失去对空间处理器中工具的访问权限，因为这些工具是跨空间的。 你还可以通过使用参数 --space-id 和 --environment-id 添加 SPACE_ID 和 ENVIRONMENT_ID

使用应用身份

除了提供管理令牌外，你还可以利用 应用身份 进行身份验证。 你需要设置并安装一个 Contentful 应用，并在调用 MCP 服务器时设置以下参数：

  • --app-id = 提供 AppToken 的应用 ID
  • --private-key = 在用户界面中与 app_id 关联创建的私钥
  • --space-id = 安装应用的空间 ID
  • --environment-id = 安装应用的环境 ID（在空间内）

使用这些值，MCP 服务器将请求一个临时 AppToken，在定义的空间/环境 ID 中执行内容操作。这对于在充当 MCP 客户端的后端系统（如聊天代理）中使用此 MCP 服务器特别有用。

在 Claude Desktop 中使用

你无需克隆此仓库即可使用此 MCP，只需将其添加到你的 claude_desktop_config.json：

编辑或添加 ~/Library/Application Support/Claude/claude_desktop_config.json 并添加以下行：

{
  "mcpServers": {
    "contentful": {
      "command": "npx",
      "args": ["-y", "@ivotoby/contentful-management-mcp-server"],
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<Your CMA token>"
      }
    }
  }
}

如果您的 MCP 客户端不支持设置环境变量，您也可以通过参数设置管理令牌，如下所示：

{
  "mcpServers": {
    "contentful": {
      "command": "npx",
      "args": [
        "-y",
        "@ivotoby/contentful-management-mcp-server",
        "--management-token",
        "<your token>",
        "--host",
        "http://api.contentful.com"
      ]
    }
  }
}

通过 Smithery 安装

要通过 Smithery 自动安装 Contentful Management Server 用于 Claude Desktop：

npx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claude

开发和使用 Claude desktop

如果你想贡献并测试 Claude 对你的贡献的反应：

  • 运行 npm run dev，这将启动监视器，每当有更改时都会重建 MCP 服务器
  • 更新 claude_desktop_config.json 以直接引用项目，例如：
{
  "mcpServers": {
    "contentful": {
      "command": "node",
      "args": ["/Users/ivo/workspace/contentful-mcp/bin/mcp-server.js"],
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<Your CMA Token>"
      }
    }
  }
}

这将允许你直接使用 Claude 测试 MCP 服务器中的任何修改，但是；如果你添加了新的工具/资源，你需要重新启动 Claude Desktop

传输模式

MCP 服务器支持两种传输模式：

stdio 传输

默认传输模式使用标准输入/输出流进行通信。这适用于与支持 stdio 传输的 MCP 客户端集成，如 Claude Desktop。

要使用 stdio 模式，只需在没有 --http 标志的情况下运行服务器：

npx -y contentful-mcp --management-token YOUR_TOKEN
# 或者
npx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN

StreamableHTTP 传输

服务器还支持 MCP 协议中定义的 StreamableHTTP 传输。此模式适用于基于 Web 的集成或当作为独立服务运行服务器时。

要使用 StreamableHTTP 模式，使用 --http 标志运行：

npx -y contentful-mcp --management-token YOUR_TOKEN --http --port 3000
# 或者
npx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN --http --port  3000

StreamableHTTP 详情

  • 使用官方 MCP StreamableHTTP 传输
  • 支持标准 MCP 协议操作
  • 包括会话管理以维持状态
  • 正确处理初始化/通知模式
  • 与标准 MCP 客户端兼容
  • 用现代方法替换已弃用的 SSE 传输

实现遵循标准 MCP 协议规范，允许任何 MCP 客户端连接到服务器而无需特殊处理。

错误处理

服务器实现了全面的错误处理，包括：

  • 认证失败
  • 速率限制
  • 无效请求
  • 网络问题
  • API 特定错误

在 MseeP 上验证

许可证

MIT 许可证

细则

此 MCP 服务器使 Claude（或其他能够消费 MCP 资源的代理）能够更新、删除内容、空间和内容模型。因此，请确保你知道你允许 Claude 对你的 Contentful 空间做什么！

此 MCP 服务器目前尚未得到 Contentful 的正式支持。