MCP 服务器

Cloudinary MCP Server

这个服务器提供了一些工具，可以使用 Claude/Cline 直接将图片和视频上传到 Cloudinary，从而方便资源管理，并提供可定制的选项，例如资源类型和公共 ID。

云存储

图像与视频处理

Tools

upload

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.

README

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

设置说明

首先，确保您拥有一个 Cloudinary 帐户，并从 Cloudinary 控制台获取您的凭据：
- Cloud Name（云名称）
- API Key（API 密钥）
- API Secret（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 desktop 应用程序，请在适合您操作系统的位置编辑配置文件。

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

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