cloudinary-mcp-server

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/*”）
     • resourceType ：资源类型（图像、视频、原始）
     • maxResults ：最大结果数（1-500）
     • nextCursor ：分页的下一个光标
     • tags ：在响应中包含标签
     • context ：在响应中包含上下文
5. 获取使用情况
   • 描述：获取产品环境使用情况的报告，包括存储、积分、带宽、请求、资源数量和附加组件使用情况
   • 参数：
     • date ：可选。使用情况报告的日期，格式为：yyyy-mm-dd。必须为最近 3 个月内的数据。默认值：当前日期