Cloudinary MCP Server

Cloudinary MCP Server

此 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 > Settings > Developer > Edit Config

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"
      }
    }
  }
}

3. 请务必将环境变量替换为从 Cloudinary Console 获取的 Cloudinary 凭据。

开发者安装

如果你想修改此服务或参与开发：

1. 克隆仓库：

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

2. 安装依赖并构建：

npm install
npm run build

设置说明

1. 首先，确保你拥有 Cloudinary 账户，并从 Cloudinary Console 获取凭据：

   • Cloud Name
   • API Key
   • API Secret

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 桌面应用，请根据你的操作系统在相应位置编辑配置文件。

3. 安装依赖并构建服务：

npm install
npm run build

可用工具

upload

将图像和视频上传到 Cloudinary。

参数：

• file（必填）：要上传的文件路径、URL 或 base64 数据 URI
• resource_type（可选）：资源类型（'image'、'video' 或 'raw'）
• public_id（可选）：上传资源的自定义 public ID
• overwrite（可选）：是否覆盖具有相同 public 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"
  }
});