Cloudinary MCP 服务器

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

工作原理

MCP 服务器：

代表您调用 Cloudinary API
允许将资产上传到 Cloudinary
支持管理 Cloudinary 云中的资产

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

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

Related MCP server: MCP Toolkit

好处

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

与 Claude Desktop 一起使用

先决条件

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

安装

要将此服务器与 Claude Desktop 应用程序一起使用，请将以下配置添加到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 密钥

工具

可以使用以下工具：

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