金大哥 - cloudinary-mcp-server MCP 详情

article

README

🚀 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 密钥

💻 使用示例

工具介绍

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

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

cloudinary-mcp-server