AI导哈

媒体管理协议服务器

Cloudinary MCP Servers 是一个标准化的协议，用于管理大型语言模型与外部系统之间的上下文，提供自然语言驱动的媒体上传、转换、分析和组织功能。适用于构建媒体丰富的应用、管理大型资产库和自动化内容工作流。

  • by cloudinary
  • 混合部署
  • 10 星标
  • 更新于
在 GitHub 查看 cloudinary/mcp-servers

使用说明

Cloudinary MCP服务器

模型上下文协议（MCP）是一种新的标准化协议，用于管理大型语言模型（LLM）和外部系统之间的上下文。该存储库为Cloudinary的媒体管理平台提供了全面的MCP服务器，使您能够使用自然语言直接从Cursor和Claude等AI应用程序上传、转换、分析和组织您的媒体资产。

借助这些MCP服务器，您可以通过对话式人工智能无缝管理整个媒体工作流程，从上传和转换图像和视频，到配置自动处理管道，使用人工智能驱动的工具分析内容，以及使用结构化元数据组织资产。无论您是构建富媒体应用程序、管理大型资产库还是自动化内容工作流，这些服务器都可以直接访问Cloudinary的全套媒体优化和管理功能。

以下MCP服务器可用于Cloudinary：

服务器名称 描述 远程MCP服务器
资产管理 使用高级搜索和组织功能上传、管理和转换您的媒体资产 资产管理
环境配置 配置和管理您的Cloudinary环境设置、上传预设和转换 环境配置
结构化元数据 创建、管理和查询结构化元数据字段，以增强资产组织和可搜索性 结构化元数据
分析 为您的媒体资产利用AI支持的内容分析、审核和自动标记功能 分析
媒体流量 在人工智能的帮助下，构建和管理图像和视频的低代码工作流程自动化 媒体流量

目录

文档

有关使用Cloudinary MCP服务器的详细指南、教程和综合文档：

安装

远程MCP服务器（推荐）

远程MCP服务器由Cloudinary托管，可立即使用。无需本地安装。

本地MCP服务器

本地MCP服务器使用npm包在您的机器上运行。如果需要更多控制或自定义，请选择此选项。

备注：您需要配置环境变量(CLOUDINARY_CLOUD_NAME, CLOUDINARY_API_KEY, CLOUDINARY_API_SECRET)安装后使用您的实际凭据。

Docker镜像

Cloudinary MCP服务器的官方Docker镜像可在Docker Hub上获得，为在本地或云环境中运行MCP服务器提供了容器化部署选项。

在Docker Hub上可用： Cloudinary MCP Docker镜像

Docker镜像提供了几个好处：

  • 孤立的环境 -在容器中运行MCP服务器，而不影响您的系统依赖关系
  • 轻松部署 -快速设置，所需配置最少
  • 一致的运行时间 -确保不同机器和平台上的环境相同
  • 可扩展性 -轻松部署多个实例或集成到容器编排系统中

要使用Docker镜像，请确保您的系统上安装了Docker，并在运行容器时将您的Cloudinary凭据作为环境变量传递。有关具体使用说明，请参阅Docker Hub上的单个Docker镜像文档。

配置示例

远程MCP服务器配置

远程服务器由Cloudinary托管，并通过以下URL访问：

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp"
    },
    "cloudinary-env-config-remote": {
      "url": "https://environment-config.mcp.cloudinary.com/mcp"
    },
    "cloudinary-smd-remote": {
      "url": "https://structured-metadata.mcp.cloudinary.com/mcp"
    },
    "cloudinary-analysis-remote": {
      "url": "https://analysis.mcp.cloudinary.com/sse"
    },
    "mediaflows": {
      "url": "https://mediaflows.mcp.cloudinary.com/v2/mcp"
    }
  }
}

运输： 远程服务器支持两个端点-- /mcp （流式HTTP，推荐，无状态）和 /sse （SSE已弃用，为向后兼容而保留）。这 /sse 端点还接受POST请求作为别名 /mcp，因此向发送Streamable HTTP的客户端 /sse 将工作。使用 /mcp 对于新的配置。

具有身份验证的远程MCP服务器

Cloudinary托管的远程MCP服务器默认使用OAuth2进行身份验证。您还可以通过头使用API密钥进行身份验证：

使用CLOUDINARY_URL（最简单）

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name"
      }
    }
  }
}

使用单个标头

{
  "mcpServers": {
    "cloudinary-env-config-remote": {
      "url": "https://environment-config.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-cloud-name": "your_cloud_name",
        "cloudinary-api-key": "your_api_key",
        "cloudinary-api-secret": "your_api_secret"
      }
    }
  }
}

使用自定义配置

{
  "mcpServers": {
    "cloudinary-smd-remote": {
      "url": "https://structured-metadata.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name",
        "cloudinary-region": "api-eu",
        "cloudinary-tools": "list-metadata-fields,get-metadata-field,create-metadata-field"
      }
    }
  }
}

带有调试标头

要在工具结果中显示API速率限制标头和请求ID，请启用标头嵌入：

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name",
        "cloudinary-embed-headers": "true"
      }
    }
  }
}

每个工具结果将包括 _headers 带有速率限制和请求跟踪信息的字段：

{
  "_headers": {
    "x-featureratelimit-limit": "10000",
    "x-featureratelimit-remaining": "9998",
    "x-featureratelimit-reset": "Thu, 13 Feb 2026 00:00:00 GMT",
    "x-request-id": "bfeaccc60050594832508590a358a1a4"
  }
}

本地MCP服务器配置

本地服务器使用npm包在您的机器上运行：

选项1：使用CLOUDINARY_URL环境变量（推荐）

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/asset-management-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-env-config": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/environment-config-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-smd": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/structured-metadata-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-analysis": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/analysis", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    }
  }
}

选项2：使用单个环境变量

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/asset-management-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "cloud_name",
        "CLOUDINARY_API_KEY": "api_key",
        "CLOUDINARY_API_SECRET": "api_secret"
      }
    }
  }
}

选项3：使用命令行参数

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": [
        "-y", "--package", "@cloudinary/asset-management-mcp",
        "--",
        "mcp", "start",
        "--cloud-name", "cloud_name",
        "--api-key", "api_key",
        "--api-secret", "api_secret"
      ]
    }
  }
}

MediaFlows MCP服务器配置

对于MediaFlows，请使用以下配置：

{
  "mcpServers": {
    "mediaflows": {
      "url": "https://mediaflows.mcp.cloudinary.com/v2/mcp",
      "headers": {
        "cld-cloud-name": "cloud_name",
        "cld-api-key": "api_key",
        "cld-secret": "api_secret"
      }
    }
  }
}

高级本地服务器配置

每个npm包都支持上述基本设置示例之外的其他配置选项。

作为SSE服务器运行

要使用服务器发送事件（SSE）传输而不是stdio运行本地MCP服务器，请执行以下操作：

npx -y --package @cloudinary/asset-management-mcp -- mcp start --transport sse

您可以指定自定义端口（默认为2718）：

npx -y --package @cloudinary/asset-management-mcp -- mcp start --transport sse --port 3000

可用配置选项

要查看任何软件包的所有可用配置选项，请执行以下操作：

npx -y --package @cloudinary/asset-management-mcp -- mcp start --help

可用标志的完整列表：

USAGE
  mcp start [--transport stdio|sse] [--port value] [--tool value]...
            [--scope admin|builder|librarian] [--api-key value]
            [--api-secret value] [--oauth2 value] [--cloud-name value]
            [--server-url value] [--server-index value]
            [--region api|api-eu|api-ap] [--api-host value]
            [--log-level debug|warning|info|error] [--env value]...

FLAGS
  --transport       The transport to use for communicating with the server
                    [stdio|sse, default = stdio]
  --port            The port to use when the SSE transport is enabled
                    [default = 2718]
  --tool...         Specify tools to mount on the server (repeatable)
  --scope           Mount tools/resources that match given scope
                    [admin|builder|librarian]
  --api-key         Sets the apiKey auth field for the API
  --api-secret      Sets the apiSecret auth field for the API
  --oauth2          Sets the oauth2 auth field for the API
  --cloud-name      Allows setting the cloudName parameter for all operations
  --server-url      Overrides the default server URL used by the SDK
  --server-index    Selects a predefined server used by the SDK
  --region          Sets the region variable for url substitution
                    [api|api-eu|api-ap]
  --api-host        Sets the host variable for url substitution
  --log-level       The log level to use for the server
                    [debug|warning|info|error, default = info]
  --env...          Environment variables made available to the server
  -h, --help        Print help information and exit

调试

有关详细的网络有效负载调试，请使用 CLOUDINARY_DEBUG 环境变量：

CLOUDINARY_DEBUG=true npx -y --package @cloudinary/asset-management-mcp -- mcp start

您可以将调试模式与其他选项相结合，以进行全面的故障排除：

CLOUDINARY_DEBUG=true npx -y --package @cloudinary/asset-management-mcp -- mcp start --transport sse --log-level debug

注： 这些配置选项适用于所有本地MCP包：

  • @cloudinary/asset-management-mcp
  • @cloudinary/environment-config-mcp
  • @cloudinary/structured-metadata-mcp
  • @cloudinary/analysis

认证

在本地运行MCP服务器时，可以通过多种方式配置身份验证：

选项1：单个环境变量（推荐）

export CLOUDINARY_CLOUD_NAME="cloud_name"
export CLOUDINARY_API_KEY="api_key"
export CLOUDINARY_API_SECRET="api_secret"

选项2:CLOUDINARY_URL环境变量

export CLOUDINARY_URL="cloudinary://api_key:api_secret@cloud_name"

选项3：命令行参数

直接将凭据作为参数传递（请参阅上面的配置示例）

您可以在您的 Cloudinary控制台仪表板 在“设置”>“安全”下。

按服务器列出的功能

资产管理服务器

  • 上传和管理媒体资产（图像、视频、原始文件）
  • 使用高级过滤功能搜索和组织资产
  • 处理资产操作和转换
  • 管理文件夹、标签和资产关系
  • 生成存档和下载链接

环境配置服务器

  • 配置上传预设和转换设置
  • 管理流媒体配置文件和webhook通知
  • 设置上传映射

结构化元数据服务器

  • 创建和管理结构化元数据字段
  • 配置条件元数据规则和验证
  • 组织和搜索元数据配置
  • 处理元数据字段关系和排序

分析服务器

  • 基于人工智能的内容分析，包括标签、审核和字幕
  • 基于多AI模型的目标检测与识别
  • 图像质量分析和水印检测
  • 内容审核和安全分析
  • 时尚、文字和解剖检测功能

MediaFlows服务器

  • 使用自然语言构建和管理工作流自动化
  • 查询您环境中现有的PowerFlow自动化
  • 基于元数据、标签和资产属性创建条件逻辑
  • 自动化资产审核、批准和通知工作流
  • 调试并了解现有的自动化配置

需要访问更多Cloudinary工具？

我们将继续为这些MCP服务器添加更多功能。如果您想留下反馈、提交错误或提供功能请求，请在此存储库上打开问题。

故障排除

“克劳德的回答被打断了……”

如果您看到此消息，Claude可能已达到其上下文长度限制，并在回复过程中停止。这通常发生在触发许多链式工具调用的服务器上，例如具有大型资产列表的资产管理服务器。

为了减少遇到此问题的机会：

  • 尽量具体，保持你的查询简洁。
  • 如果一个请求调用多个工具，请尝试将其分解为几个较小的工具调用，以保持响应简短。
  • 使用筛选参数限制资产搜索和列表的范围。

身份验证问题

确保您的Cloudinary凭据配置正确，并且具有您尝试执行的操作所需的权限。

付费功能

某些功能可能需要付费的Cloudinary计划。确保您的Cloudinary帐户具有您打算使用的功能所需的订阅级别，例如：

  • 高级AI分析功能
  • 高容量API使用
  • 先进的转换能力

许可证

根据MIT许可证获得许可。有关详细信息，请参阅LICENSE文件。

相关 MCP