Contentful MCP Server 使用说明

项目简介

Contentful MCP Server 是一个 MCP (Model Context Protocol) 服务器的实现，它允许LLM客户端（如 Claude Desktop）通过标准化的 MCP 协议与 Contentful 内容管理系统进行交互。该服务器提供了一系列工具，使得LLM能够查询、创建、更新和删除 Contentful 中的内容条目 (Entries)、资产 (Assets)、内容类型 (Content Types) 和空间 (Spaces)。

主要功能点

内容管理: 支持内容条目和资产的完整 CRUD (创建、读取、更新、删除) 操作。
空间管理: 支持空间的创建、更新和管理，以及环境的管理。
内容类型管理: 支持内容类型定义的管理。
本地化: 支持多语言环境。
发布: 支持内容发布工作流的控制。

简而言之，通过此 MCP 服务器，你可以让 LLM 具备操作和管理 Contentful 内容的能力。

安装步骤

方法一：通过 Smithery 安装 (推荐)

确保已安装 Node.js 和 npm。

打开终端，运行以下命令，即可自动安装 Contentful Management Server 并配置 Claude Desktop (或其他 Smithery 客户端):

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

方法二：手动配置 Claude Desktop

无需克隆此仓库，打开 Claude Desktop 的配置文件 'claude_desktop_config.json'。该文件通常位于 '~/Library/Application Support/Claude/' (macOS) 或用户应用数据目录下的 Claude 文件夹中。
编辑或创建 'claude_desktop_config.json' 文件，添加以下 JSON 配置到 'mcpServers' 字段中。如果 'mcpServers' 字段不存在，请创建它。
```
{
  "mcpServers": {
    "contentful": {
      "command": "npx",
      "args": ["-y", "@ivotoby/contentful-management-mcp-server"],
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<Your CMA token>"
      }
    }
  }
}
```
- "contentful": 服务器名称，可以自定义，用于在 Claude Desktop 中标识该 MCP 服务器。
- "command": "npx": 启动服务器的命令，这里使用 'npx' 来运行 npm 包。
- "args": ["-y", "@ivotoby/contentful-management-mcp-server"]: 'npx' 命令的参数，'-y' 表示自动确认安装包，'@ivotoby/contentful-management-mcp-server' 是要运行的 npm 包名称，即 Contentful MCP Server。
- "env": 环境变量配置。
- "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<Your CMA token>": 必须配置。Contentful Management API 访问令牌，用于服务器连接 Contentful。请替换 '<Your CMA token>' 为你实际的 Contentful Management API 令牌。你需要在 Contentful 后台的 "Settings" -> "API keys" 中生成该令牌。

服务器配置 (MCP 客户端配置)

以下是在 MCP 客户端 (例如 Claude Desktop) 中配置 Contentful MCP Server 的 JSON 格式配置信息：

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

server name: 'contentful' (自定义服务器名称，用于客户端识别)
command: 'npx' (运行命令，使用 npx 运行 npm 包)
args: '["-y", "@ivotoby/contentful-management-mcp-server"]' (命令参数，指定要运行的 npm 包)
env: 环境变量
- CONTENTFUL_MANAGEMENT_ACCESS_TOKEN: '<Your CMA token>' (Contentful Management API 令牌，请务必替换为你的令牌)

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端 (如 Claude Desktop) 中，你就可以使用该 MCP 服务器提供的工具来操作 Contentful 内容了。

例如，你可以指示 Claude 使用 'search_entries' 工具来搜索 Contentful 中的内容条目，或者使用 'create_entry' 工具来创建新的内容条目。工具的具体使用方法和参数可以参考仓库 README.md 文件中 "Tools" 部分的详细描述。

重要提示: 该 MCP 服务器允许 LLM 客户端更新和删除 Contentful 中的内容，包括条目、空间和内容模型。请务必谨慎使用，并确保你了解 LLM 对 Contentful 空间的操作权限，避免造成数据丢失或意外修改。

关键词