🚀 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": "" ,
"CLOUDINARY_API_SECRET": ""
}
}
}
}
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 个月内。默认值：当前日期。