Image Downloader
About
一个支持图片下载和处理的 MCP (Model Context Protocol) 服务器，具有进度跟踪、批量下载和图片处理功能。
Details
- Author
- cced3000
- Downloads
- 214
- Categories
- Media
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Image DownloaderCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"image downloader": {
"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"
}
}
}
}
}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"
}
}
}Image Downloader MCP Server
一个支持图片下载和处理的 MCP (Model Context Protocol) 服务器，具有进度跟踪、批量下载和图片处理功能。
功能特性
- 🖼️ 单张图片下载
- 📦 批量图片下载
- 🔄 实时进度跟踪
- 🎨 图片格式转换 (JPEG, PNG, WebP)
- 📏 图片尺寸调整
- 🗜️ 图片压缩
- 🌐 代理服务器支持
- ⚙️ 环境变量配置支持
安装
方式一：通过 npx 安装（推荐）
直接使用 npx 运行，无需本地安装：
npx mcp-image-downloader
方式二：全局安装
npm install -g mcp-image-downloader
方式三：本地开发安装
git clone https://github.com/cced3000/mcp-image-downloader.git
cd mcp-image-downloader
npm install
npx 的优势
使用 npx 方式有以下优势：
- ✅ 无需本地安装，始终使用最新版本
- ✅ 自动处理依赖关系
- ✅ 减少本地存储空间占用
- ✅ 避免版本冲突问题
- ✅ 配置更简单，无需指定路径
配置
环境变量配置
复制 .env.example 到 .env 并根据需要修改配置：
cp .env.example .env
可配置的环境变量：
| 环境变量 | 描述 | 默认值 | 示例 |
|---------|------|--------|------|
| DEFAULT_SAVE_PATH | 默认下载目录 | ./downloads | /Users/username/Pictures |
| DEFAULT_FILENAME | 默认文件名模式 | 原始文件名 | image_{timestamp} |
| DEFAULT_FORMAT | 默认图片格式 | original | jpeg, png, webp |
| DEFAULT_COMPRESS | 默认压缩设置 | false | true, false |
| DEFAULT_MAX_WIDTH | 默认最大宽度 | 无限制 | 1920 |
| DEFAULT_MAX_HEIGHT | 默认最大高度 | 无限制 | 1080 |
| DEFAULT_CONCURRENCY | 默认并发数 | 3 | 1-10 |
| HTTP_PROXY | HTTP 代理服务器 | 无 | http://proxy.example.com:8080 |
| HTTPS_PROXY | HTTPS 代理服务器 | 无 | http://proxy.example.com:8080 |
MCP 客户端配置
Cursor IDE 配置
使用 npx（推荐）：
在 .cursor/mcp.json 中添加：
{
"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"
}
}
}
}
使用本地安装：
{
"mcpServers": {
"image-downloader": {
"command": "node",
"args": ["src/index.js"],
"cwd": "/path/to/testmcp",
"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"
}
}
}
}
Claude Desktop 配置
使用 npx（推荐）：
在 claude_desktop_config.json 中添加：
{
"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"
}
}
}
}
使用本地安装：
{
"mcpServers": {
"image-downloader": {
"command": "node",
"args": ["src/index.js"],
"cwd": "/path/to/testmcp",
"env": {
"DEFAULT_SAVE_PATH": "/Users/username/Downloads/images",
"DEFAULT_FORMAT": "jpeg",
"DEFAULT_COMPRESS": "true",
"HTTPS_PROXY": "http://proxy.example.com:8080"
}
}
}
}
使用方法
通过 MCP 客户端使用
配置好 MCP 客户端后，可以直接在支持 MCP 的应用中使用图片下载功能。
本地开发和测试
启动服务器
npm start
开发模式
npm run dev
测试
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
