Cloudinary MCP Server

基本能力

产品定位

Cloudinary MCP Server 主要用于内容生成，特别是图片和视频的上传和管理。

核心功能

1. 上传功能：支持上传图片、视频和原始文件到 Cloudinary。
2. 自定义配置：允许用户自定义上传资源的公共 ID、资源类型、标签等。
3. 覆盖控制：可以选择是否覆盖已存在的资源。

适用场景

1. 内容管理：适用于需要批量上传和管理图片、视频的内容管理系统。
2. 开发者工具：开发者可以通过该服务快速集成 Cloudinary 的上传功能到自己的应用中。
3. 自动化流程：适用于需要自动化上传资源的场景，如自动化测试或批量处理。

工具列表

1. upload：上传图片和视频到 Cloudinary。
2. 参数：
   • file（必需）：文件路径、URL 或 base64 数据 URI。
   • resource_type（可选）：资源类型（'image'、'video' 或 'raw'）。
   • public_id（可选）：自定义公共 ID。
   • overwrite（可选）：是否覆盖现有资源。
   • tags（可选）：分配给上传资源的标签数组。

常见问题解答

1. 如何获取 Cloudinary 凭证？
2. 从 Cloudinary Console 获取 Cloud Name、API Key 和 API Secret。
3. 如何配置服务器？
4. 在 Claude/Cline MCP 设置文件中添加服务器配置，并替换环境变量为您的 Cloudinary 凭证。

使用教程

使用依赖

1. 安装 Node.js（版本 18 或更高）和 npm： bash node --version npm --version

安装教程

1. 推荐使用 npx 安装：
2. 导航到 Claude 配置目录：
   • Windows: C:\Users\NAME\AppData\Roaming\Claude
   • macOS: ~/Library/Application Support/Claude/

3. 添加以下配置到 MCP 设置文件： json { "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" } } } }

4. 开发者安装：

5. 克隆仓库： bash git clone https://github.com/felores/cloudinary-mcp-server.git cd cloudinary-mcp-server
6. 安装依赖并构建： bash npm install npm run build

调试方式

1. 确保已正确配置 Cloudinary 凭证。
2. 使用以下命令测试上传功能： typescript use_mcp_tool({ server_name: "cloudinary", tool_name: "upload", arguments: { file: "path/to/image.jpg", resource_type: "image", public_id: "my-custom-id" } });

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。