Cloudinary MCP 服务器

这是一个 Model Context Protocol 服务器，它将 Cloudinary 上传和管理 API 方法作为 AI 助手的工具进行暴露。这种集成允许 AI 系统触发并与您的 Cloudinary 云进行交互。

工作原理

MCP 服务器：

• 代表您调用 Cloudinary API
• 允许上传资源到 Cloudinary
• 允许管理您 Cloudinary 云中的资源

它依赖于 Cloudinary API 来执行这些操作。并非所有方法和参数都受支持。随着时间推移会添加更多功能。

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

优点

• 将您的 Cloudinary 云操作转换为 AI 助手可调用的工具
• 将您的 Cloudinary 资源转换为 AI 助手的数据

与 Claude 桌面版一起使用

前提条件

• NodeJS
• MCP 客户端（如 Claude 桌面应用程序）
• 在 API 密钥 页面创建并复制 Cloudinary API 密钥/密钥

安装

要将此服务器与 Claude 桌面应用程序一起使用，请在 claude_desktop_config.json 文件的 "mcpServers" 部分中添加以下配置：

{
    "mcpServers": {
        "cloudinary-mcp-server": {
            "command": "npx",
            "args": ["-y", "cloudinary-mcp-server"],
            "env": {
                "CLOUDINARY_CLOUD_NAME": "<cloud name>",
                "CLOUDINARY_API_KEY": "<api-key>",
                "CLOUDINARY_API_SECRET": "<api-secret>"
            }
        }
    }
}

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

工具

以下工具可用：

1. upload

   • 描述：将文件（资源）上传到 Cloudinary
   • 参数：
     • source: 要上传的 URL、文件路径、base64 内容或二进制数据
     • folder: 可选的 Cloudinary 文件夹路径
     • publicId: 上传资源的可选公共 ID
     • resourceType: 要上传的资源类型 (image, video, raw, auto)
     • tags: 分配给资源的标签列表，用逗号分隔

2. delete-asset

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

3. get-asset

   • 描述：获取特定文件（资源）的详细信息
   • 参数：
     • assetId: Cloudinary 资产 ID
     • publicId: 资源的公共 ID
     • resourceType: 资源类型 (image, raw, video)
     • type: 交付类型 (upload, private, authenticated, 等)
     • tags: 是否包含标签名称列表
     • context: 是否包含上下文元数据
     • metadata: 是否包含结构化元数据

4. find-assets

   • 描述：使用查询表达式在 Cloudinary 中搜索现有文件（资源）
   • 参数：
     • expression: 搜索表达式（例如 'tags=cat' 或 'public_id:folder/*'）
     • resourceType: 资源类型 (image, video, raw)
     • maxResults: 最大结果数 (1-500)
     • nextCursor: 用于分页的下一个游标
     • tags: 在响应中包含标签
     • context: 在响应中包含上下文

5. get-usage

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