Cloudinary MCP Server

🚀 Cloudinary MCP 服务器

Cloudinary MCP 服务器是一个模型上下文协议服务器，它借助 AI 助手将 Cloudinary 的上传和管理 API 方法以工具的形式公开。这种集成方式让 AI 系统能够触发并与您的 Cloudinary 云进行交互，为您的云操作和资源管理带来了新的便利。

🚀 快速开始

工作原理

该 MCP 服务器主要负责代表您调用 Cloudinary API，具体功能如下：

• 允许 AI 助手上传文件到 Cloudinary。
• 支持对您的 Cloudinary 云资源进行管理。

不过，它依赖于 Cloudinary 的 API 来执行这些操作，目前并非所有方法和参数都受支持，后续会逐步添加更多功能。如果您需要特定的方法，请在 问题 中提交请求。

优势

• 将您的 Cloudinary 云操作转化为 AI 助手的可调用工具，让操作更加便捷。
• 把您的 Cloudinary 资源转化为供 AI 助手使用的数据，提升资源利用率。

📦 安装指南

使用 Claude Desktop

先决条件

• NodeJS
• MCP 客户端（如 Claude Desktop App）
• 在 API 密钥 处创建并复制 Cloudinary API Key/Secret

安装步骤

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

{
    "mcpServers": {
        "cloudinary-mcp-server": {
            "command": "npx",
            "args": ["-y", "cloudinary-mcp-server"],
            "env": {
                "CLOUDINARY_CLOUD_NAME": "<云名称>",
                "CLOUDINARY_API_KEY": "<API密钥>",
                "CLOUDINARY_API_SECRET": "<API密钥>"
            }
        }
    }
}

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

💻 使用示例

工具介绍

以下是该服务器提供的可用工具：

1. 上传

   • 描述：将文件（资产）上传到 Cloudinary。
   • 参数：
     • source: URL、文件路径、Base64 内容或要上传的二进制数据。
     • folder: 可选的 Cloudinary 文件夹路径。
     • publicId: 可选的上传文件的公共 ID。
     • resourceType: 要上传资源的类型（图像、视频、原始、自动）。
     • tags: 以逗号分隔的标签列表，用于分配到资产。

2. 删除资产

   • 描述：从 Cloudinary 中删除特定文件（资产）。
   • 参数：
     • publicId: 要删除的资产的公共 ID。
     • assetId: 要删除的资产的资产 ID。

3. 获取资产

   • 描述：获取指定文件（资产）的详细信息。
   • 参数：
     • assetId: Cloudinary 资产 ID。
     • publicId: 资产的公共 ID。
     • resourceType: 资源类型（图像、原始、视频）。
     • type: 交付类型（上传、私有、经过身份验证等）。
     • tags: 是否包括标签名称列表。
     • context: 是否包含上下文元数据。
     • metadata: 是否包含结构化元数据。

4. 查找资产

   • 描述：使用查询表达式在 Cloudinary 中搜索现有文件（资产）。
   • 参数：
     • expression: 搜索表达式（例如'标签=猫'或'public_id:folder/*'）。
     • resourceType: 资源类型（图像、原始、视频）。
     • maxResults: 结果的最大数量。
     • nextCursor: 用于分页的游标。

5. 获取使用情况

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