Cloudinary

What is Cloudinary MCP Server?

Cloudinary MCP Server is a Model Context Protocol (MCP) server designed to facilitate the uploading of images and videos to Cloudinary. It integrates with Claude Desktop and other compatible MCP clients, providing a streamlined way to manage media assets on the Cloudinary platform.

How to use Cloudinary MCP Server?

To use Cloudinary MCP Server, you need Node.js (version 18 or higher) and npm. The recommended installation method is via npx, which involves adding a configuration to your Claude settings file with your Cloudinary credentials (Cloud Name, API Key, API Secret). Alternatively, for development or modification, you can clone the repository, install dependencies, and build the project. Once set up, you can utilize the upload tool within Claude/Cline to upload files by providing the file path, resource type, and optional parameters like public_id, overwrite, and tags.

Key Features of Cloudinary MCP Server

• Media Upload: Supports uploading of images and videos to Cloudinary.
• Claude Desktop Integration: Seamlessly works with Claude Desktop and other MCP-compatible clients.
• Configurable: Allows configuration of Cloudinary credentials via environment variables.
• Flexible Upload Options: Provides parameters for specifying resource type, custom public IDs, overwrite options, and tags during upload.
• Developer Friendly: Offers a developer installation path for contributions and modifications.

Use Cases of Cloudinary MCP Server

• Automated Media Uploads: Automate the process of uploading visual content to Cloudinary from applications or scripts.
• Content Management: Integrate with content management workflows to easily add and manage media assets.
• Application Development: Developers can use this server to build applications that require Cloudinary media management capabilities.
• Batch Processing: Efficiently upload multiple media files to Cloudinary using scripting or automated tools.

FAQ from Cloudinary MCP Server

Q: What are the requirements for running Cloudinary MCP Server? A: You need Node.js (version 18 or higher) and npm installed on your system.

Q: How do I get my Cloudinary credentials? A: You can obtain your Cloud Name, API Key, and API Secret from the Cloudinary Console under API Keys.

Q: Can I upload both images and videos? A: Yes, the server supports uploading both images and videos, and you can specify the resource_type during the upload process.

Q: Is it possible to set a custom public ID for uploaded assets? A: Yes, you can use the public_id parameter to specify a custom public ID for your uploaded assets.

Q: How do I contribute to the development of Cloudinary MCP Server? A: You can clone the repository, install dependencies, and build the project to start contributing or modifying the server.

Cloudinary MCP Server

This MCP server provides tools for uploading images and videos to Cloudinary through Claude Desktop and compatible MCP clients.

Installation

Requirements: Node.js

1. Install Node.js (version 18 or higher) and npm from nodejs.org
2. Verify installation:

   node --version
   npm --version
   

Install using npx (Recommended)

1. Navigate to the Claude configuration directory:

   • Windows: C:\Users\NAME\AppData\Roaming\Claude
   • macOS: ~/Library/Application Support/Claude/

   You can also find these directories inside the Claude Desktop app: Claude Desktop > Settings > Developer > Edit Config

2. Add the following configuration to your MCP settings file:

{
  "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. Make sure to replace the environment variables with your Cloudinary credentials from the Cloudinary Console.

Developer Installation

If you want to modify the server or contribute to development:

1. Clone the repository:

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

2. Install dependencies and build:

npm install
npm run build

Setup Instructions

1. First, ensure you have a Cloudinary account and get your credentials from the Cloudinary Console:

   • Cloud Name
   • API Key
   • API Secret

2. Add the server configuration to your Claude/Cline MCP settings file:

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

For Claude desktop app, edit the configuration file at the appropriate location for your OS.

3. Install dependencies and build the server:

npm install
npm run build

Available Tools

upload

Upload images and videos to Cloudinary.

Parameters:

• file (required): Path to file, URL, or base64 data URI to upload
• resource_type (optional): Type of resource ('image', 'video', or 'raw')
• public_id (optional): Custom public ID for the uploaded asset
• overwrite (optional): Whether to overwrite existing assets with the same public ID
• tags (optional): Array of tags to assign to the uploaded asset

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