Contentful MCP Server

Contentful MCP Server

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

简介

这是一个与 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 打开检查器界面测试和调试工具。