A
securityA
licenseA
qualityThis server generates placeholder image URLs from various providers, supporting input validation and integration with desktop applications like Claude and Cursor.
Last updated -
1
9
MIT License
The Cloudinary MCP Server enables you to upload and manage media files on Cloudinary via Claude Desktop and compatible MCP clients.
Upload Media: Upload images, videos, and raw files using a file path, URL, or base64 data URI
Customization: Set custom public IDs, add tags for organization, and control overwrite options for existing assets
Large File Handling: Process large files in chunks with streaming responses for video uploads
URL Generation: Access uploaded assets via auto-generated HTTPS/HTTP URLs
Integration: Seamlessly integrates with Claude Desktop via MCP server configuration
Provides tools for uploading images and videos to Cloudinary through Claude Desktop and compatible MCP clients
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
Install Node.js (version 18 or higher) and npm from nodejs.org
Verify installation:
node --version npm --version
Install using npx (Recommended)
Navigate to the Claude configuration directory:
Windows:
C:\Users\NAME\AppData\Roaming\ClaudemacOS:
~/Library/Application Support/Claude/
You can also find these directories inside the Claude Desktop app: Claude Desktop > Settings > Developer > Edit Config
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"
}
}
}
}
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:
Clone the repository:
git clone https://github.com/felores/cloudinary-mcp-server.git
cd cloudinary-mcp-server
Install dependencies and build:
npm install
npm run build
Setup Instructions
First, ensure you have a Cloudinary account and get your credentials from the Cloudinary Console:
Cloud Name
API Key
API Secret
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.
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 uploadresource_type(optional): Type of resource ('image', 'video', or 'raw')public_id(optional): Custom public ID for the uploaded assetoverwrite(optional): Whether to overwrite existing assets with the same public IDtags(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"
}
});
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that exposes Cloudinary Upload & Admin API methods as tools by AI assistants. This integration allows AI systems to trigger and interact with your Cloudinary cloud.Last updated -5261MIT License
- -securityFlicense-qualityA server that enables uploading files to Qiniu Cloud Storage through a standardized MCP interface, providing a simple way to store and serve files with public URLs.Last updated -27
- -securityAlicense-qualityA lightweight MCP server for image processing and cloud uploads that automates resizing, converting, optimizing, and uploading images to services like AWS S3, Cloudflare R2, and Google Cloud Storage.Last updated -1915MIT License