Cloudinary MCP 服务器

模型上下文协议服务器，将 Cloudinary 上传和管理 API 方法作为 AI 助手的工具公开。此集成允许 AI 系统触发 Cloudinary 云并与其交互。

工作原理

MCP 服务器：

• 代表您调用 Cloudinary API

• 允许将资产上传到 Cloudinary

• 支持管理 Cloudinary 云中的资产

它依赖于 Cloudinary API来执行这些操作。并非所有方法和参数都受支持。未来将添加更多支持。

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

好处

• 将您的 Cloudinary 云操作转变为可供 AI 助手调用的工具

• 将您的 Cloudinary 资产转化为 AI 助手的数据

与 Claude Desktop 一起使用

先决条件

• NodeJS

• MCP 客户端（如 Claude 桌面应用程序）

• 创建并复制 Cloudinary API 密钥/秘密： API KEYS

安装

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

• CLOUDINARY_CLOUD_NAME - 您的云名称

• CLOUDINARY_API_KEY - 您的云的 API 密钥

• CLOUDINARY_API_SECRET - 您的云的 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 ：搜索表达式（例如“tags=cat”或“public_id:folder/*”）

     • resourceType ：资源类型（图像、视频、原始）

     • maxResults ：最大结果数（1-500）

     • nextCursor ：分页的下一个光标

     • tags ：在响应中包含标签

     • context ：在响应中包含上下文

5. 获取使用情况

   • 描述：获取产品环境使用情况的报告，包括存储、积分、带宽、请求、资源数量和附加组件使用情况

   • 参数：

     • date ：可选。使用情况报告的日期，格式为：yyyy-mm-dd。必须为最近 3 个月内的数据。默认值：当前日期