Cloudinary MCP Server

Cloudinary MCP 服务

一个 Model Context Protocol 服务，可将 Cloudinary Upload 和 Admin 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 Key/Secret：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 Key
• CLOUDINARY_API_SECRET - 你的云的 API Secret

工具

以下工具可用：

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。必须在最近 3 个月内。默认值：当前日期