Image Downloader
@cced3000
About Image Downloader
一个支持图片下载和处理的 MCP (Model Context Protocol) 服务器，具有进度跟踪、批量下载和图片处理功能。
Config
Add this server to your MCP-compatible client using the configuration below.
{
"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"
}
}
}
}Tools
No tools detected
Fetch the live tool list by running this server in a temporary sandbox using the button above.
Overview
What is Image Downloader?
Image Downloader is an MCP (Model Context Protocol) server for downloading and processing images. It supports single and batch downloads with real-time progress tracking, image format conversion (JPEG, PNG, WebP), resizing, compression, and proxy configuration. It is intended for developers and users who need programmatic image downloading via MCP-compatible clients like Cursor or Claude Desktop.
How to use Image Downloader?
Install via npx (npx mcp-image-downloader), npm global install, or local clone. Configure the server in your MCP client’s JSON settings (e.g., .cursor/mcp.json or claude_desktop_config.json), optionally setting environment variables like DEFAULT_SAVE_PATH, DEFAULT_FORMAT, HTTP_PROXY, etc. Then invoke the tools download_image (single) or download_images_batch (batch) with parameters such as URL, format, compression, max dimensions, and proxy.
Key features of Image Downloader
- Single image download with optional processing
- Batch download of multiple images with concurrent control
- Real-time progress tracking (percentage, speed, ETA)
- Image format conversion to JPEG, PNG, WebP, or original
- Image resizing by max width and height
- Image compression
- Proxy support (HTTP, HTTPS, SOCKS5, with authentication)
- Configuration via environment variables and MCP client settings
Use cases of Image Downloader
- Download a single image and convert it to WebP with compression
- Batch download multiple images while resizing them to a maximum width of 1920px
- Download images from behind a corporate firewall using an HTTP proxy
- Automate image collection for a blog or data pipeline with concurrency control
- Process images on-the-fly (format, size, compression) during download
FAQ from Image Downloader
What runtime does Image Downloader require?
Image Downloader is a Node.js package. You need Node.js and npm installed to run it via npx or global installation.
How do I configure proxy for downloads?
Proxy can be set globally via the HTTP_PROXY and HTTPS_PROXY environment variables, or per-request using the proxy parameter in tool calls. Supported formats include HTTP, HTTPS, SOCKS5, and authenticated proxies.
What image formats are supported for conversion?
The server can convert to JPEG, PNG, WebP, or keep the original format. The default is original.
Can I limit download concurrency?
Yes. Set the DEFAULT_CONCURRENCY environment variable (default 3, range 1–10) or pass the concurrency parameter in download_images_batch.
Where are downloaded images saved?
By default, images are saved to ./downloads relative to the working directory. You can change this with the DEFAULT_SAVE_PATH environment variable or by specifying savePath in the tool call.
Frequently asked questions
What runtime does Image Downloader require?
Image Downloader is a Node.js package. You need Node.js and npm installed to run it via npx or global installation.
How do I configure proxy for downloads?
Proxy can be set globally via the `HTTP_PROXY` and `HTTPS_PROXY` environment variables, or per-request using the `proxy` parameter in tool calls. Supported formats include HTTP, HTTPS, SOCKS5, and authenticated proxies.
What image formats are supported for conversion?
The server can convert to JPEG, PNG, WebP, or keep the original format. The default is `original`.
Can I limit download concurrency?
Yes. Set the `DEFAULT_CONCURRENCY` environment variable (default 3, range 1–10) or pass the `concurrency` parameter in `download_images_batch`.
Where are downloaded images saved?
By default, images are saved to `./downloads` relative to the working directory. You can change this with the `DEFAULT_SAVE_PATH` environment variable or by specifying `savePath` in the tool call.
Basic information
More Media & Design MCP servers
Instagram + TikTok Downloader & Transcriber
IYIAInstagram + TikTok content tools inside your AI: download HD posts/reels/carousels, view Instagram stories anonymously, AI-transcribe videos (100+ languages, SRT/VTT/TXT). Requires a Repost PRO subscription.
Spotify MCP Server
marcelmaraisLightweight MCP server for Spotify
diggercamp
Tommaso Savorana (ti es)diggercamp finds independent music by how it sounds. Paste any Bandcamp, YouTube or SoundCloud link and get the closest sonic matches from 4M+ independent tracks — matched by rhythm, timbre, key and energy, not genre tag
Spotify MCP
varunnealMCP to connect your LLM with Spotify.
Uwear.ai
Uwear.aiRun complete AI fashion photoshoots from ChatGPT, Claude, or Codex. Turn flat-lay, packshot, and mannequin product images into catalog-ready on-model photos and video with saved art direction, automatic QA, and catalog-s
Comments