Contentful MCP Server

Contentful MCP Server

用于内容富管理API的MCP（模型上下文协议）服务器。

GitHub
Created Byivo-tobyivo-toby

简介

这是一个与 Contentful 内容管理 API 集成的 MCP 服务器，提供全面的内容管理功能，可与支持 MCP 的 AI 工具（如 Claude Desktop）配合使用。

contentful-mcp MCP 服务器

快速安装

Claude Desktop 设置

您无需克隆仓库，只需编辑 Claude Desktop 配置文件：

# 编辑配置文件
vim ~/Library/Application\ Support/Claude/claude_desktop_config.json

添加以下配置：

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

通过 Smithery 一键安装

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

主要功能

  • 内容管理：完整的条目和资产CRUD操作
  • 空间管理：创建、更新和管理空间与环境
  • 内容类型：管理内容模型定义
  • 批量操作：批量发布、取消发布和验证
  • 分页支持：智能分页防止上下文溢出（每次返回最多3个项目）

配置选项

环境变量或命令行参数

  • CONTENTFUL_MANAGEMENT_ACCESS_TOKEN / --management-token：CMA令牌
  • CONTENTFUL_HOST / --host：API端点（默认为 https://api.contentful.com）
  • SPACE_ID / --space-id：限定操作范围到特定空间
  • ENVIRONMENT_ID / --environment-id：限定操作范围到特定环境

应用身份验证（可选）

{
  "args": [
    "--app-id", "<应用ID>",
    "--private-key", "<私钥>",
    "--space-id", "<空间ID>",
    "--environment-id", "<环境ID>"
  ]
}

可用工具概览

  • 条目管理：search_entries, create_entry, get_entry, update_entry, delete_entry...
  • 资产管理：list_assets, upload_asset, get_asset, update_asset, publish_asset...
  • 批量操作：bulk_publish, bulk_unpublish, bulk_validate
  • 空间与环境：list_spaces, get_space, list_environments, create_environment...
  • 内容类型：list_content_types, get_content_type, create_content_type...

开发调试

# 启动检查器
npm run inspect

# 监视模式自动重启
npm run inspect:watch

# 开发模式（文件变更时重新构建）
npm run dev

访问 http://localhost:5173 打开检查器界面测试和调试工具。