🚀 Cloudinary MCP 服务器

此 MCP 服务器为通过 Claude Desktop 及兼容的 MCP 客户端将图像和视频上传到 Cloudinary 提供工具，助力用户便捷地完成相关操作。

点击此处

🚀 快速开始

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

3. 确保将环境变量替换为从 Cloudinary 控制台 获取的实际 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 控制台 获取你的凭证：
   • 云名称
   • 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 桌面应用程序，编辑相应位置的配置文件。 3. 安装依赖项并构建服务器：

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