云图视频处理服务
一个模型上下文协议服务器,将Cloudinary上传和管理API方法作为AI助手的工具进行暴露。 这种集成允许AI系统触发并 interacts 与您的Cloudinary云交互。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"cloudinary-mcp-server": {
"args": [
"-y",
"cloudinary-mcp-server"
],
"command": "npx",
"env": {
"CLOUDINARY_API_KEY": "\u003capi-key\u003e",
"CLOUDINARY_API_SECRET": "\u003capi-secret\u003e",
"CLOUDINARY_CLOUD_NAME": "\u003ccloud name\u003e"
}
}
}
}
该服务需要配置环境变量:CLOUDINARY_API_KEY、CLOUDINARY_API_SECRET、CLOUDINARY_CLOUD_NAME
可用工具 (5 个)
该服务在 MCP 协议中暴露的工具,AI 可按需调用
upload 5 个参数 需填 1 项
Upload a file (asset) to Cloudinary
必填参数:source
delete-asset 2 个参数
Delete a file (asset) from Cloudinary
该工具无需必填参数,直接调用即可
get-asset 7 个参数
Get the details of a specific file (asset)
该工具无需必填参数,直接调用即可
find-assets 6 个参数
Search for existing files (assets) in Cloudinary with a query expression
该工具无需必填参数,直接调用即可
get-usage 1 个参数
Get a report on the status of your product environment usage, including storage, credits, bandwidth, requests, number of resources, and add-on usage
该工具无需必填参数,直接调用即可
服务介绍
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 密钥
工具
以下工具可用:
-
upload
- 描述:将文件(资源)上传到 Cloudinary
- 参数:
source: 要上传的 URL、文件路径、base64 内容或二进制数据folder: 可选的 Cloudinary 文件夹路径publicId: 上传资源的可选公共 IDresourceType: 要上传的资源类型 (image, video, raw, auto)tags: 分配给资源的标签列表,用逗号分隔
-
delete-asset
- 描述:从 Cloudinary 中删除文件(资源)
- 参数:
publicId: 要删除的资源的公共 IDassetId: 要删除的资源的资产 ID
-
get-asset
- 描述:获取特定文件(资源)的详细信息
- 参数:
assetId: Cloudinary 资产 IDpublicId: 资源的公共 IDresourceType: 资源类型 (image, raw, video)type: 交付类型 (upload, private, authenticated, 等)tags: 是否包含标签名称列表context: 是否包含上下文元数据metadata: 是否包含结构化元数据
-
find-assets
- 描述:使用查询表达式在 Cloudinary 中搜索现有文件(资源)
- 参数:
expression: 搜索表达式(例如 'tags=cat' 或 'public_id:folder/*')resourceType: 资源类型 (image, video, raw)maxResults: 最大结果数 (1-500)nextCursor: 用于分页的下一个游标tags: 在响应中包含标签context: 在响应中包含上下文
-
get-usage
- 描述:获取有关您的产品环境使用情况的报告,包括存储、积分、带宽、请求、资源数量和附加组件使用情况
- 参数:
date: 可选。使用情况报告的日期格式为 yyyy-mm-dd。必须在过去三个月内。默认值:当前日期