云存储上传工具

@felores/cloudinary-mcp-server
Hosted
0 Stars 505 次浏览 felores 更新于 2026-08-23

该服务器提供工具,可使用Claude/Cline将图像和视频直接上传到Cloudinary,通过可自定义的选项(如资源类型和公共ID)方便资源管理。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

该服务需要配置环境变量:CLOUDINARY_API_KEY、CLOUDINARY_API_SECRET、CLOUDINARY_CLOUD_NAME

可用工具 (1 个)

该服务在 MCP 协议中暴露的工具,AI 可按需调用

upload 5 个参数 需填 1 项

Upload media (images/videos) to Cloudinary. For large files, the upload is processed in chunks and returns a streaming response. The uploaded asset will be available at: - HTTP: http://res.cloudinary.com/{cloud_name}/{resource_type}/upload/v1/{public_id}.{format} - HTTPS: https://res.cloudinary.com/{cloud_name}/{resource_type}/upload/v1/{public_id}.{format} where cloud_name='dadljfaoz', resource_type is 'image' or 'video', and format is determined by the file extension.

必填参数:file

服务介绍

Cloudinary MCP 服务器

该MCP服务器提供了通过Claude Desktop和兼容的MCP客户端上传图片和视频到Cloudinary的工具。

安装

要求:Node.js

  1. nodejs.org安装Node.js(版本18或更高)及npm
  2. 验证安装:
    node --version
    npm --version
    

使用npx安装(推荐)

  1. 导航至Claude配置目录:

    • Windows: C:\Users\NAME\AppData\Roaming\Claude
    • macOS: ~/Library/Application Support/Claude/

    您也可以在Claude Desktop应用中找到这些目录:Claude Desktop > 设置 > 开发者 > 编辑配置

  2. 将以下配置添加到您的MCP设置文件中:

{
  "mcpServers": {
    "cloudinary": {
      "command": "npx",
      "args": ["@felores/cloudinary-mcp-server@latest"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "your_cloud_name",
        "CLOUDINARY_API_KEY": "your_api_key",
        "CLOUDINARY_API_SECRET": "your_api_secret"
      }
    }
  }
}
  1. 确保将环境变量替换为来自Cloudinary 控制台的Cloudinary凭证。

开发者安装

如果您想要修改服务器或贡献于开发工作:

  1. 克隆仓库:
git clone https://github.com/felores/cloudinary-mcp-server.git
cd cloudinary-mcp-server
  1. 安装依赖并构建项目:
npm install
npm run build

设置说明

  1. 首先,确保您拥有一个Cloudinary账号,并从Cloudinary 控制台获取您的凭证:

    • 云名称
    • API密钥
    • API密钥秘密
  2. 将服务器配置添加到您的Claude/Cline MCP设置文件中:

{
  "mcpServers": {
    "cloudinary": {
      "command": "node",
      "args": ["c:/path/to/cloudinary-mcp-server/dist/index.js"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "your_cloud_name",
        "CLOUDINARY_API_KEY": "your_api_key",
        "CLOUDINARY_API_SECRET": "your_api_secret"
      }
    }
  }
}

对于Claude桌面应用程序,请根据您的操作系统编辑相应位置的配置文件。

  1. 安装依赖并构建服务器:
npm install
npm run build

可用工具

upload

向Cloudinary上传图片和视频。

参数:

  • file (必需): 文件路径、URL 或 base64 数据 URI 用于上传
  • resource_type (可选): 资源类型 ('image', 'video' 或 'raw')
  • public_id (可选): 上传资源的自定义公开ID
  • overwrite (可选): 是否覆盖具有相同公开ID的现有资源
  • tags (可选): 分配给上传资源的标签数组

在Claude/Cline中的示例使用方法:

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

相关 MCP 服务