云图视频处理服务

@yoavniran/cloudinary-mcp-server
Hosted
0 Stars 524 次浏览 yoavniran 更新于 2026-08-23

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

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "cloudinary-mcp-server": {
      "args": [
        "-y",
        "cloudinary-mcp-server"
      ],
      "command": "npx",
      "env": {
        "CLOUDINARY_API_KEY": "\u003capi-key\u003e",
        "CLOUDINARY_API_SECRET": "\u003capi-secret\u003e",
        "CLOUDINARY_CLOUD_NAME": "\u003ccloud name\u003e"
      }
    }
  }
}

该服务需要配置环境变量:CLOUDINARY_API_KEY、CLOUDINARY_API_SECRET、CLOUDINARY_CLOUD_NAME

可用工具 (5 个)

该服务在 MCP 协议中暴露的工具,AI 可按需调用

upload 5 个参数 需填 1 项

Upload a file (asset) to Cloudinary

必填参数:source

delete-asset 2 个参数

Delete a file (asset) from Cloudinary

该工具无需必填参数,直接调用即可

get-asset 7 个参数

Get the details of a specific file (asset)

该工具无需必填参数,直接调用即可

find-assets 6 个参数

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

该工具无需必填参数,直接调用即可

get-usage 1 个参数

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

该工具无需必填参数,直接调用即可

服务介绍

Cloudinary MCP 服务器

这是一个 Model Context Protocol 服务器,它将 Cloudinary 上传和管理 API 方法作为 AI 助手的工具进行暴露。这种集成允许 AI 系统触发并与您的 Cloudinary 云进行交互。

工作原理

MCP 服务器:

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

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

如果您需要特定的方法,请打开一个 问题 请求。

优点

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

与 Claude 桌面版一起使用

前提条件

  • NodeJS
  • MCP 客户端(如 Claude 桌面应用程序)
  • API 密钥 页面创建并复制 Cloudinary API 密钥/密钥

安装

要将此服务器与 Claude 桌面应用程序一起使用,请在 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 密钥

工具

以下工具可用:

  1. upload

    • 描述:将文件(资源)上传到 Cloudinary
    • 参数:
      • source: 要上传的 URL、文件路径、base64 内容或二进制数据
      • folder: 可选的 Cloudinary 文件夹路径
      • publicId: 上传资源的可选公共 ID
      • resourceType: 要上传的资源类型 (image, video, raw, auto)
      • tags: 分配给资源的标签列表,用逗号分隔
  2. delete-asset

    • 描述:从 Cloudinary 中删除文件(资源)
    • 参数:
      • publicId: 要删除的资源的公共 ID
      • assetId: 要删除的资源的资产 ID
  3. get-asset

    • 描述:获取特定文件(资源)的详细信息
    • 参数:
      • assetId: Cloudinary 资产 ID
      • publicId: 资源的公共 ID
      • resourceType: 资源类型 (image, raw, video)
      • type: 交付类型 (upload, private, authenticated, 等)
      • tags: 是否包含标签名称列表
      • context: 是否包含上下文元数据
      • metadata: 是否包含结构化元数据
  4. find-assets

    • 描述:使用查询表达式在 Cloudinary 中搜索现有文件(资源)
    • 参数:
      • expression: 搜索表达式(例如 'tags=cat' 或 'public_id:folder/*')
      • resourceType: 资源类型 (image, video, raw)
      • maxResults: 最大结果数 (1-500)
      • nextCursor: 用于分页的下一个游标
      • tags: 在响应中包含标签
      • context: 在响应中包含上下文
  5. get-usage

    • 描述:获取有关您的产品环境使用情况的报告,包括存储、积分、带宽、请求、资源数量和附加组件使用情况
    • 参数:
      • date: 可选。使用情况报告的日期格式为 yyyy-mm-dd。必须在过去三个月内。默认值:当前日期

相关 MCP 服务