项目简介

Contentstack MCP 服务器是一个实现了 Model Context Protocol (MCP) 的应用后端。它作为大语言模型 (LLM) 客户端和 Contentstack 内容管理系统之间的桥梁，将 Contentstack 提供的丰富的内容管理和操作功能转化为 LLM 可以理解和调用的标准化工具。

通过连接到此 MCP 服务器，LLM 客户端可以无需了解复杂的 Contentstack API 细节，直接通过自然语言或结构化请求来访问和操作 Contentstack 中的内容、资产、分类、发布流程等。

主要功能点

该 MCP 服务器提供了广泛的功能，涵盖 Contentstack 内容管理的多个方面，主要包括：

• 内容管理： 支持对不同内容类型的内容条目进行创建、读取、更新、删除（CRUD）操作，管理内容版本、多语言变体。
• 资产管理： 对媒体资产进行读取、删除、发布、解除发布，并查看资产引用关系。
• 分类和术语： 管理分类（Taxonomies）及其层级结构的术语（Terms）。
• 发布工作流： 发布和解除发布内容及资产到指定环境和语言，支持发布调度。
• 多语言支持： 本地化和解除本地化内容条目，管理多种语言设置。
• 环境和分支管理： 查看和管理 Contentstack 中的不同环境和开发分支。
• 版本发布管理： 创建、克隆、添加/删除条目到版本发布，并部署版本发布。
• 灵活查询： 支持对内容进行分页、过滤、排序和包含关联数据的查询。

这些功能都以 MCP 工具的形式提供，使得 LLM 可以直接调用。

安装步骤

该 MCP 服务器是基于 Node.js 构建的。您需要确保系统已安装 Node.js 环境。

最简单的安装和运行方式是使用 'npx' 命令，它会临时下载并执行软件包：

1. 确保您的系统已安装 Node.js 和 npm。
2. 准备您的 Contentstack API 密钥（Stack API Key）和管理令牌（Management Token）。您可以从 Contentstack 堆栈设置中获取。
3. 配置您的 MCP 客户端（如支持 MCP 的 LLM 应用程序）。配置信息如下述“服务器配置”部分所示。当客户端启动并尝试连接时，它会自动通过 'npx' 运行服务器。

服务器配置

MCP 客户端（如 Claude Desktop 等支持 MCP 的 LLM 应用程序）需要配置如何启动并连接到此 MCP 服务器。配置通常是 JSON 格式，您需要在客户端的配置界面或文件中添加一个服务器条目，包含以下关键信息：

• 'name': 给这个服务器起一个名字，例如 "Contentstack"。
• 'command': 启动 MCP 服务器的命令。对于 Contentstack MCP，通常是 'npx'。
• 'args': 传递给命令的参数列表。使用 'npx' 时，参数通常是 '@contentstack/mcp'，后面可以跟 Contentstack 的认证信息参数。
• 'env': 设置服务器运行所需的环境变量。您可以在这里设置 Contentstack 的认证信息。

一个典型的配置示例（描述而非代码）：

配置一个名为 "contentstack" 的服务器。 其启动命令是 'npx'， 启动参数列表是 '-y' 和 '@contentstack/mcp'。 它需要的环境变量包括：

• 'CONTENTSTACK_API_KEY'：您的 Contentstack 堆栈 API 密钥。
• 'CONTENTSTACK_MANAGEMENT_TOKEN'：您的 Contentstack 管理令牌。
• 'CONTENTSTACK_REGION'：您的 Contentstack 区域 (例如 'NA', 'EU' 等)。

如果您不想使用环境变量，也可以将认证信息作为启动参数传递：

配置一个名为 "contentstack" 的服务器。 其启动命令是 'npx'， 启动参数列表是 '-y', '@contentstack/mcp', '--management-token', '<您的管理令牌>', '--stack-api-key', '<您的API密钥>', '--region', '<您的区域>'。 在此情况下，'env' 可以为空或省略。

请根据您的 MCP 客户端的具体要求和界面，填写相应的配置项。

基本使用方法

1. 按照上述步骤配置并启动您的 MCP 客户端。客户端会自动启动 Contentstack MCP 服务器并建立连接。
2. 一旦连接成功，您的 LLM 客户端将能够识别 Contentstack MCP 服务器提供的工具能力（例如，显示可用的 Contentstack 工具列表）。
3. 您现在可以通过向 LLM 发送指令来执行 Contentstack 操作。例如，您可以说：“请使用 Contentstack MCP 服务器，列出内容类型为 'blog_post' 的所有内容条目”，或者“创建一个标题为 '我的新文章' 的内容条目”。
4. LLM 会根据您的指令，调用 Contentstack MCP 服务器提供的相应工具，服务器则会执行对应的 Contentstack API 请求并将结果返回给 LLM。