Contentful MCP

🚀 内容丰富的MCP服务器

一个功能强大的MCP（机器学习控制平面）服务器，允许Claude或其他类似的人工智能代理与内容管理系统Contentful进行交互。该服务器提供对空间、环境、内容模型以及内容本身的全面管理能力。

✨ 主要特性

• 内容模型管理：创建、更新和删除内容模型
• 内容操作：在指定环境中高效地增删改查内容
• 环境隔离：支持在特定的Contentful空间和环境下运行，防止误操作
• 安全机制：集成了全面的身份验证和权限控制，确保数据安全
• 可扩展性：支持通过插件或自定义工具进行功能扩展

📚 详细文档

功能概述

内容模型管理

• 创建新的内容模型，包括字段类型、验证规则等配置
• 更新现有模型的结构和属性
• 删除不再需要的内容模型

内容操作

• 在指定环境中高效地增删改查内容
• 支持批量操作，提升处理效率
• 提供详细的历史记录，便于追踪变更

环境隔离

• 可配置特定的空间ID和环境ID，确保所有操作都在指定范围内进行
• 防止误操作带来的数据损失或安全风险

安全机制

• 身份验证：支持使用Contentful的管理API令牌和应用标识（App Identity）双重认证方式
• 权限控制：通过设置允许的操作范围，限制AI代理的能力，防止未经授权的访问
• 审计日志：记录所有操作的历史，便于后续审查和追溯

可扩展性

• 支持通过插件系统扩展功能，用户可以根据需求添加自定义工具
• 提供灵活的配置选项，适应不同工作流和使用场景

📦 安装指南

使用Smithery自动安装

对于希望快速上手的用户，可以通过Smithery一键安装：

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

手动安装与配置

1. 克隆仓库

git clone https://github.com/yourusername/contentful-mcp.git
cd contentful-mcp

2. 安装依赖

npm install

3. 配置环境变量 更新claude_desktop_config.json文件，添加以下内容：

{
  "mcpServers": {
    "contentful": {
      "command": "node",
      "args": ["bin/mcp-server.js"],
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<你的管理API令牌>"
      }
    }
  }
}

4. 启动服务器

npm run dev

💻 使用示例

通过Claude Desktop使用

无需克隆仓库，直接在claude_desktop_config.json中添加以下配置：

{
  "mcpServers": {
    "contentful": {
      "command": "npx",
      "args": ["-y", "@ivotoby/contentful-management-mcp-server"],
      "env": {
        "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<你的管理API令牌>"
      }
    }
  }
}

使用App Identity进行认证

如果你更倾向于使用Contentful的应用标识（App Identity）进行身份验证，可以执行以下步骤：

• 注册并创建一个Contentful应用
• 配置如下环境变量或命令行参数：

--app-id <你的应用ID>
--private-key <你的私钥>
--space-id <目标空间ID>
--environment-id <目标环境ID>

🔧 技术细节

该服务器集成了全面的错误处理机制，能够应对以下常见问题：

• 认证失败：当提供的令牌或标识无效时
• 速率限制：超过Contentful API的调用限制时
• 无效请求：请求参数不符合规范时
• 网络问题：临时性连接故障
• API错误：Contentful API返回的特定错误

📄 许可证

MIT License

⚠️ 重要提示

该MCP服务器赋予Claude或其他AI代理对内容模型、空间和环境进行管理的能力。因此，在授予这些权限时，请务必谨慎，确保了解每项操作的具体影响。建议在生产环境中部署前，先在测试环境下进行全面的测试和验证。