MCP 服务器

cloudinary-mcp-server

一个模型上下文协议服务器，它将 Cloudinary 上传和管理 API 方法作为 AI 助手的工具公开。此集成允许 AI 系统触发并与您的 Cloudinary 云进行交互。

Tools

upload

Upload a file (asset) to Cloudinary

delete-asset

Delete a file (asset) from Cloudinary

get-asset

Get the details of a specific file (asset)

find-assets

Search for existing files (assets) in Cloudinary with a query expression

get-usage

Get a report on the status of your product environment usage, including storage, credits, bandwidth, requests, number of resources, and add-on usage

README

Cloudinary MCP 服务器

一个模型上下文协议 (Model Context Protocol, MCP) 服务器，它将 Cloudinary 上传和管理 API 方法作为 AI 助手的工具公开。此集成允许 AI 系统触发并与您的 Cloudinary 云进行交互。

工作原理

MCP 服务器：

代表您调用 Cloudinary API
允许将资源上传到 Cloudinary
允许管理您 Cloudinary 云中的资源

它依赖 Cloudinary API 来执行这些操作。并非所有方法和参数都受支持。随着时间的推移，将添加更多方法和参数。

如果您需要特定方法，请打开一个 issue 提出请求。

优势

将您的 Cloudinary 云操作转换为 AI 助手可调用的工具
将您的 Cloudinary 资源转换为 AI 助手的数据

与 Claude Desktop 一起使用

前提条件

NodeJS
MCP 客户端（例如 Claude Desktop App）
在以下位置创建并复制 Cloudinary API 密钥/密码：API KEYS

安装

要将此服务器与 Claude Desktop 应用程序一起使用，请将以下配置添加到 claude_desktop_config.json 的 "mcpServers" 部分：

{
    "mcpServers": {
        "cloudinary-mcp-server": {
            "command": "npx",
            "args": ["-y", "cloudinary-mcp-server"],
            "env": {
                "CLOUDINARY_CLOUD_NAME": "<cloud name>",
                "CLOUDINARY_API_KEY": "<api-key>",
                "CLOUDINARY_API_SECRET": "<api-secret>"
            }
        }
    }
}

CLOUDINARY_CLOUD_NAME - 您的云名称
CLOUDINARY_API_KEY - 您的云的 API 密钥
CLOUDINARY_API_SECRET - 您的云的 API 密码

工具

以下工具可用：

upload
- 描述：将文件（资源）上传到 Cloudinary
- 参数：
  - source：要上传的 URL、文件路径、base64 内容或二进制数据
  - folder：Cloudinary 中的可选文件夹路径
  - publicId：上传资源的可选公共 ID
  - resourceType：要上传的资源类型（图像、视频、原始、自动）
  - tags：要分配给资源的逗号分隔的标签列表
delete-asset
- 描述：从 Cloudinary 删除文件（资源）
- 参数：
  - publicId：要删除的资源的公共 ID
  - assetId：要删除的资源的资源 ID
get-asset
- 描述：获取特定文件（资源）的详细信息
- 参数：
  - assetId：Cloudinary 资源 ID
  - publicId：资源的公共 ID
  - resourceType：资源类型（图像、原始、视频）
  - type：交付类型（上传、私有、已验证等）
  - tags：是否包含标签名称列表
  - context：是否包含上下文元数据
  - metadata：是否包含结构化元数据
find-assets
- 描述：使用查询表达式在 Cloudinary 中搜索现有文件（资源）
- 参数：
  - expression：搜索表达式（例如 'tags=cat' 或 'public_id:folder/*'）
  - resourceType：资源类型（图像、视频、原始）
  - maxResults：最大结果数 (1-500)
  - nextCursor：用于分页的下一个游标
  - tags：在响应中包含标签
  - context：在响应中包含上下文
get-usage
- 描述：获取有关您的产品环境使用情况的状态报告，包括存储、信用额度、带宽、请求、资源数量和附加组件使用情况
- 参数：
  - date：可选。使用情况报告的日期，格式为：yyyy-mm-dd。必须在最近 3 个月内。默认值：当前日期