Cloudinary MCP 服务器

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

安装

要求：Node.js

从nodejs.org安装 Node.js（版本 18 或更高版本）和 npm
验证安装：
```
node --version
npm --version
```

使用 npx 安装（推荐）

导航到 Claude 配置目录：
- Windows： C:\Users\NAME\AppData\Roaming\Claude
- macOS： ~/Library/Application Support/Claude/
您还可以在 Claude Desktop 应用程序中找到这些目录：Claude Desktop > 设置 > 开发人员 > 编辑配置
将以下配置添加到您的 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"
      }
    }
  }
}

确保使用Cloudinary 控制台中的 Cloudinary 凭据替换环境变量。

开发人员安装

如果您想修改服务器或参与开发：

克隆存储库：

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

安装依赖项并构建：

npm install
npm run build

Related MCP server: cloudinary-mcp-server

设置说明

首先，确保您拥有 Cloudinary 帐户并从Cloudinary 控制台获取您的凭据：
- 云名称
- API 密钥
- API 秘密
将服务器配置添加到您的 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 桌面应用程序，请在适合您的操作系统的位置编辑配置文件。

安装依赖项并构建服务器：

npm install
npm run build

可用工具

上传

将图像和视频上传到 Cloudinary。

参数：

file （必需）：要上传的文件路径、URL 或 base64 数据 URI
resource_type （可选）：资源类型（“图像”、“视频”或“原始”）
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"
  }
});