https://github.com/felores/cloudinary-mcp-server
MCP (Model Context Protocol) server for uploading media to Cloudinary using Claude Desktop
https://github.com/felores/cloudinary-mcp-server
Last synced: 23 days ago
JSON representation
MCP (Model Context Protocol) server for uploading media to Cloudinary using Claude Desktop
- Host: GitHub
- URL: https://github.com/felores/cloudinary-mcp-server
- Owner: felores
- License: mit
- Created: 2025-01-07T23:43:22.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2025-03-12T18:24:19.000Z (about 1 month ago)
- Last Synced: 2025-03-12T18:41:43.983Z (about 1 month ago)
- Language: JavaScript
- Homepage:
- Size: 33.2 KB
- Stars: 4
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- Awesome-MCP-Servers-directory - Cloudinary - Cloudinary Model Context Protocol Server to upload media to Cloudinary and get back the media link and details (Cloud Platforms)
- awesome-mcp-servers - Cloudinary - MCP (Model Context Protocol) server for uploading media to Cloudinary using Claude Desktop (Table of Contents / Cloud Storage)
- awesome-mcp-servers - Cloudinary - MCP (Model Context Protocol) server for uploading media to Cloudinary using Claude Desktop (Table of Contents / Cloud Storage)
README
# 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](https://nodejs.org/)
2. Verify installation:
```bash
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:
```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"
}
}
}
}
```
3. Make sure to replace the environment variables with your Cloudinary credentials from the [Cloudinary Console](https://console.cloudinary.com/settings/api-keys).
### Developer Installation
If you want to modify the server or contribute to development:
1. Clone the repository:
```bash
git clone https://github.com/felores/cloudinary-mcp-server.git
cd cloudinary-mcp-server
```
2. Install dependencies and build:
```bash
npm install
npm run build
```
## Setup Instructions
1. First, ensure you have a Cloudinary account and get your credentials from the [Cloudinary Console](https://console.cloudinary.com/settings/api-keys):
- Cloud Name
- API Key
- API Secret
2. Add the server configuration to your Claude/Cline MCP settings file:
```json
{
"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:
```bash
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:
```typescript
use_mcp_tool({
server_name: "cloudinary",
tool_name: "upload",
arguments: {
file: "path/to/image.jpg",
resource_type: "image",
public_id: "my-custom-id"
}
});