Cloudinary MCP Server

基本能力

产品定位

Cloudinary MCP Server 是一个专为Claude Desktop及兼容MCP客户端设计的服务，主要用于将图片和视频上传至Cloudinary平台。

核心功能

• 上传图片和视频到Cloudinary
• 支持多种资源类型（图片、视频、原始文件）
• 可自定义公共ID和标签
• 支持覆盖现有资源

适用场景

• 需要将媒体文件上传至Cloudinary的应用
• 需要自动化处理媒体文件上传的工作流
• 需要集成Cloudinary服务的开发项目

工具列表

• upload: 上传图片和视频到Cloudinary
• 参数:
  • file (必填): 文件路径、URL或base64数据URI
  • resource_type (可选): 资源类型（'image', 'video', 或 'raw'）
  • public_id (可选): 自定义公共ID
  • overwrite (可选): 是否覆盖具有相同公共ID的现有资源
  • tags (可选): 分配给上传资源的标签数组

使用教程

使用依赖

• 需要Node.js环境
• 需要Cloudinary账户及API凭证

安装教程

快速安装（推荐）

npx @felores/cloudinary-mcp-server

安装后，将以下配置添加到Claude/Cline MCP设置文件中：

{
  "mcpServers": {
    "cloudinary": {
      "command": "npx",
      "args": ["@felores/cloudinary-mcp-server"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "your_cloud_name",
        "CLOUDINARY_API_KEY": "your_api_key",
        "CLOUDINARY_API_SECRET": "your_api_secret"
      }
    }
  }
}

开发者安装

1. 克隆仓库：

git clone https://github.com/felores/cloudinary-mcp-server.git
cd cloudinary-mcp-server

1. 安装依赖并构建：

npm install
npm run build

调试方式

1. 确保已正确配置Cloudinary凭证
2. 使用示例代码测试上传功能：

use_mcp_tool({
  server_name: "cloudinary",
  tool_name: "upload",
  arguments: {
    file: "path/to/image.jpg",
    resource_type: "image",
    public_id: "my-custom-id"
  }
});

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。