云资源管理服务器

一个将Cloudinary上传和管理API方法暴露为AI助手工具的模型上下文协议服务器,使AI系统能够触发和与您的Cloudinary云进行交互。

  • by yoavniran
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 yoavniran/cloudinary-mcp-server

使用说明

Cloudinary MCP服务器

模型上下文协议服务器,将Cloudinary Upload和Admin API方法公开为人工智能助手的工具。 这种集成允许AI系统触发您的Cloudinary云并与之交互。

运作原理

MCP服务器:

  • 代表您致电Cloudinary API
  • 允许将资产上传到Cloudinary
  • 支持对Cloudinary云中的资产进行管理

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

打开一个 问题 如果需要,可以请求特定的方法。

益处

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

使用Claude Desktop

先决条件

  • NodeJS 的
  • MCP客户端(如克劳德桌面应用程序)
  • 创建并复制Cloudinary API密钥/机密,网址: API密钥

安装

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

{
    "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. 上传

    • 说明:将文件(资产)上传到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个月内。默认值:当前日期