使用说明

项目简介

Cloudinary MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端（如 Claude Desktop）提供便捷的媒体资源上传功能。通过集成 Cloudinary 的云存储服务，该服务器允许 LLM 应用调用工具上传图片和视频，从而扩展 LLM 在多媒体内容处理方面的能力。

主要功能点

图片和视频上传: 提供 'upload' 工具，支持将本地文件、URL 或 Base64 编码的图片和视频上传到 Cloudinary 云平台。
多资源类型支持: 支持上传 image、video 和 raw 等多种资源类型。
灵活的上传参数: 允许自定义上传资源的 public_id、overwrite 选项和 tags，方便用户进行资源管理。
返回上传结果: 上传成功后，返回包含资源 URL、安全 URL 等详细信息的 JSON 响应，方便 LLM 应用进一步使用。
易于集成: 通过简单的配置，即可将该 MCP 服务器集成到支持 MCP 协议的 LLM 客户端中。

安装步骤

安装 Node.js: 确保已安装 Node.js (版本 18 或更高版本)。您可以从 nodejs.org 下载并安装。
配置 MCP 服务器: 打开 Claude Desktop 或其他兼容 MCP 客户端的配置文件，通常位于用户配置目录下的 MCP 设置文件中。
添加服务器配置: 在 MCP 配置文件的 'mcpServers' 字段中添加以下 JSON 配置，用于注册 Cloudinary MCP Server。

服务器配置

以下是配置 Cloudinary MCP Server 的 JSON 代码，请添加到您的 MCP 客户端配置文件中。

{
  "mcpServers": {
    "cloudinary": {
      "command": "npx",
      "args": ["@felores/cloudinary-mcp-server"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "your_cloud_name",  // 替换为您的 Cloudinary Cloud Name
        "CLOUDINARY_API_KEY": "your_api_key",      // 替换为您的 Cloudinary API Key
        "CLOUDINARY_API_SECRET": "your_api_secret"   // 替换为您的 Cloudinary API Secret
      }
    }
  }
}

配置参数说明:

'server name': '"cloudinary"' (服务器名称，在 LLM 客户端调用工具时使用).
'command': '"npx"' (运行服务器的命令，'npx' 用于执行 npm 包).
'args': '["@felores/cloudinary-mcp-server"]' (传递给命令的参数，这里是 Cloudinary MCP Server 的 npm 包名).
'env': (环境变量配置，用于传递 Cloudinary API 凭据).
- 'CLOUDINARY_CLOUD_NAME': 您的 Cloudinary Cloud Name，可以在 Cloudinary 控制台获取。
- 'CLOUDINARY_API_KEY': 您的 Cloudinary API Key，可以在 Cloudinary 控制台获取。
- 'CLOUDINARY_API_SECRET': 您的 Cloudinary API Secret，可以在 Cloudinary 控制台获取。

重要: 请务必将 '"your_cloud_name"'、'"your_api_key"' 和 '"your_api_secret"' 替换为您的实际 Cloudinary API 凭据。您可以在 Cloudinary Console 中找到这些信息。

基本使用方法

在支持 MCP 协议的 LLM 客户端（例如 Claude 或 Cline）中，您可以使用 'use_mcp_tool' 函数调用 'cloudinary' 服务器的 'upload' 工具来上传文件。以下是一个使用示例：

use_mcp_tool({
  server_name: "cloudinary",
  tool_name: "upload",
  arguments: {
    file: "path/to/your/image.jpg",  // 替换为要上传的图片的文件路径、URL 或 Base64 数据 URI
    resource_type: "image",         // 可选：资源类型，可以是 "image"、"video" 或 "raw"，默认为 "auto"
    public_id: "my-image-id"        // 可选：自定义 Public ID
  }
});

将 'file' 参数替换为要上传的图片或视频的实际路径、URL 或 Base64 数据 URI。您可以根据需要设置 'resource_type' 和 'public_id' 等参数。

关键词