cced3000/mcp-image-downloader

Developer tools

This page was translated automatically. Technical details may differ from the original. View the original

22 stars 3 forks Quality 75 Trend 30

Repository Install

MCP server for downloading and processing images from URLs

Overview

An MCP (Model Context Protocol) server supporting image download and processing, featuring progress tracking, batch downloads, and image processing functions. - 🖼️ Single image download - 📦 Batch image download - 🔄 Real-time progress tracking - 🎨 Image format conversion (JPEG, PNG, WebP) - 📏 Image size adjustment - 🗜️ Image compression - 🌐 Proxy server support - ⚙️ Environment variable configuration support The advantages of using NPX are as follows: - ✅ No need for local installation, always using the latest version - ✅ Automatically handles dependencies - ✅ Reduces local storage space usage - ✅ Avoids version conflicts - ✅ Simpler configuration without specifying paths - url (required): image URL - savePath (optional): Save directory, default configuration uses environment variables - filename (optional): Custom filename - format (optional): output format (jpeg, png, webp, original) - compress (optional): compression - maxWidth (optional): maximum width - maxHeight (optional): maximum height - proxy (optional): proxy server URL - urls (required): image URL array - savePath (optional): Save directory - format (optional): Output format - compress (optional): compression - maxWidth (optional): Maximum width - maxHeight (optional): maximum height - proxy (optional): proxy server URL - concurrency (optional): concurrent downloads (1-10) - proxy (optional): proxy server URL - http://proxy.example.com:8080 - Basic HTTP Proxy - https://proxy.example.com:8080 - HTTPS Proxy - http://username:[email protected]:8080 - Authenticated Proxy - socks5://proxy.example.com:1080 - SOCKS5 Proxy 1. Proxy parameters (highest priority) when calling the function 2. Environment variables HTTP_PROXY or HTTPS_PROXY 3.

Overview (machine translated)

An MCP (Model Context Protocol) server supporting image download and processing, featuring progress tracking, batch downloads, and image processing functions.

Functional Features

🖼️ Single image download
📦 Batch image downloads
🔄 Real-time progress tracking
🎨 Image format conversion (JPEG, PNG, WebP)
📏 Image size adjustment
🗜️ Image compression
🌐 Proxy server support
⚙️ Environment variable configuration support

Installation

Method One: Install via NPX (Recommended)

Run directly with NPX, no local installation required:

Method 2: Global installation

Method 3: Local Development and Installation

Advantages of NPX

The NPX method offers the following advantages:

✅ No local installation required; always use the latest version
✅ Automatically handle dependencies
✅ Reduces local storage space usage
✅ Avoid version conflicts
✅ Simpler configuration, no need to specify paths

Configuration

Environment Variable Configuration

Copy .env.example to .env and modify the configuration as needed:

Configurable environment variables:

Environment variable	Description	Default value	Example
`DEFAULT_SAVE_PATH`	Default Download Directory	`./downloads`	`/Users/username/Pictures`
`DEFAULT_FILENAME`	Default Filename Mode	Original Filename	`image_{timestamp}`
`DEFAULT_FORMAT`	Default Image Format	`original`	`jpeg`, `png`, `webp`
`DEFAULT_COMPRESS`	Default Compression Settings	`false`	`true`, `false`
`DEFAULT_MAX_WIDTH`	Default maximum width	No limit	`1920`
`DEFAULT_MAX_HEIGHT`	Default maximum height	Unlimited	`1080`
`DEFAULT_CONCURRENCY`	Default Concurrency	`3`	`1-10`
`HTTP_PROXY`	HTTP proxy server	None	`http://proxy.example.com:8080`
`HTTPS_PROXY`	HTTPS Proxy Server	None	`http://proxy.example.com:8080`

MCP client configuration

Cursor IDE Configuration

Using npx (recommended):

Add to .cursor/mcp.json:

Use local installation:

Claude Desktop configuration

Using npx (recommended):

This page was translated automatically. Technical details may differ from the original.

Install

npx mcp-image-downloader

New to MCP? Start with the mcpskill.org guide →

Configuration

{
  "mcpServers": {
    "image-downloader": {
      "command": "npx",
      "args": ["mcp-image-downloader"],
      "env": {
        "DEFAULT_SAVE_PATH": "/Users/username/Downloads/images",
        "DEFAULT_FORMAT": "jpeg",
        "DEFAULT_COMPRESS": "true",
        "HTTPS_PROXY": "http://proxy.example.com:8080",
        "DEFAULT_MAX_WIDTH": "1920",
        "DEFAULT_MAX_HEIGHT": "1080",
        "DEFAULT_CONCURRENCY": "5",
        "HTTP_PROXY": "http://proxy.example.com:8080"
      }
    }
  }
}