Image Downloader MCP

MCPAI代理

提供方 未标注

AI代理 HTTP · 远程 未标注 社区 / 第三方
查看接入方式

全面解析Image DownloaderMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器,Image Downloader能让AI助手访问实时数据、执行操作,为您提供更智能的工作体验和自动化解决方案。

一句话选型结论

按资料字段整理

Image Downloader MCP 属于AI代理类 MCP 服务器,HTTP · 远程,鉴权方式未标注,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式HTTP · 远程 鉴权未标注 部署方式远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

安装与配置

HTTP · 远程 未标注
连远程 HTTPS 端点,通常为 Streamable HTTP
npx 安装(推荐)

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Image Downloader MCP当前 未标注 HTTP · 远程 远程部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方未标注上游标注的维护方 未标注
分类AI代理本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Node.js本地安装时用到的包标识与运行时
部署类型远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.2 KB
来自项目仓库与上游目录的原文,未做删改

Image Downloader MCP Server

一个支持图片下载和处理的 MCP (Model Context Protocol) 服务器,具有进度跟踪、批量下载和图片处理功能。

功能特性

  • 🖼️ 单张图片下载
  • 📦 批量图片下载
  • 🔄 实时进度跟踪
  • 🎨 图片格式转换 (JPEG, PNG, WebP)
  • 📏 图片尺寸调整
  • 🗜️ 图片压缩
  • 🌐 代理服务器支持
  • ⚙️ 环境变量配置支持

安装

方式一:通过 npx 安装(推荐)

直接使用 npx 运行,无需本地安装:```bash
npx mcp-image-downloader


### 方式二:全局安装```bash
npm install -g mcp-image-downloader

方式三:本地开发安装```bash

git clone https://github.com/cced3000/mcp-image-downloader.git
cd mcp-image-downloader
npm install


### npx 的优势

使用 npx 方式有以下优势:
- ✅ 无需本地安装,始终使用最新版本
- ✅ 自动处理依赖关系
- ✅ 减少本地存储空间占用
- ✅ 避免版本冲突问题
- ✅ 配置更简单,无需指定路径

## 配置

### 环境变量配置

复制 `.env.example` 到 `.env` 并根据需要修改配置:```bash
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 中添加:```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"
}
}
}
}


**使用本地安装:**```json
{
  "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 中添加:```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"
}
}
}
}


**使用本地安装:**```json
{
  "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 的应用中使用图片下载功能。

本地开发和测试

启动服务器```bash

npm start


### 开发模式```bash
npm run dev

测试```bash

运行所有测试

npm test

测试进度跟踪

npm run test:progress


## MCP 工具

### download_image

下载单张图片。

**参数:**
- `url` (必需): 图片 URL
- `savePath` (可选): 保存目录,默认使用环境变量配置
- `filename` (可选): 自定义文件名
- `format` (可选): 输出格式 (jpeg, png, webp, original)
- `compress` (可选): 是否压缩
- `maxWidth` (可选): 最大宽度
- `maxHeight` (可选): 最大高度
- `proxy` (可选): 代理服务器 URL

**示例:**```json
{
  "url": "https://example.com/image.jpg",
  "format": "webp",
  "compress": true,
  "maxWidth": 800,
  "proxy": "http://proxy.example.com:8080"
}

download_images_batch

批量下载图片。

参数:
- urls (必需): 图片 URL 数组
- savePath (可选): 保存目录
- format (可选): 输出格式
- compress (可选): 是否压缩
- maxWidth (可选): 最大宽度
- maxHeight (可选): 最大高度
- proxy (可选): 代理服务器 URL
- concurrency (可选): 并发下载数 (1-10)
- proxy (可选): 代理服务器 URL

示例:```json
{
"urls": [
"https://example.com/image1.jpg",
"https://example.com/image2.png"
],
"format": "jpeg",
"concurrency": 3,
"proxy": "http://proxy.example.com:8080"
}


## 代理支持

服务器支持通过代理服务器下载图片,适用于需要通过代理访问网络的环境。

### 代理配置方式

1. **环境变量配置(全局默认)**:```bash
   export HTTP_PROXY=http://proxy.example.com:8080
   export HTTPS_PROXY=http://proxy.example.com:8080

   # 带认证的代理
   export HTTP_PROXY=http://username:password@proxy.example.com:8080
   ```

2. **参数配置(单次使用)**:
   在调用工具时通过 `proxy` 参数指定

### 支持的代理格式

- `http://proxy.example.com:8080` - 基本 HTTP 代理
- `https://proxy.example.com:8080` - HTTPS 代理
- `http://username:password@proxy.example.com:8080` - 带认证的代理
- `socks5://proxy.example.com:1080` - SOCKS5 代理

### 代理优先级

1. 函数调用时的 `proxy` 参数(最高优先级)
2. 环境变量 `HTTP_PROXY` 或 `HTTPS_PROXY`
3. 无代理(直接连接)

详细的代理使用说明请参考 PROXY_USAGE.md。

## 进度跟踪

服务器提供详细的进度信息:

- 下载进度百分比
- 已下载/总字节数
- 下载速度
- 预计剩余时间
- 批量下载的整体进度

## 故障排除

### 常见问题

1. **模块未找到错误**
   - 确保运行了 `npm install`
   - 检查 MCP 配置中的路径是否正确

2. **权限错误**
   - 确保对下载目录有写入权限
   - 在 macOS 上可能需要授予应用程序文件访问权限

3. **网络错误**
   - 检查网络连接
   - 验证图片 URL 是否可访问
   - 某些网站可能需要特定的 User-Agent
   - 如果使用代理,确保代理服务器正常运行

4. **代理连接问题**
   - 验证代理服务器地址和端口
   - 检查代理认证信息是否正确
   - 确保代理服务器支持目标协议

### 调试

启用详细日志:```bash
DEBUG=* npm start

许可证

MIT

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Image Downloader MCP 怎么安装?

在客户端按下面的安装命令接入:npx 安装(推荐)。装完在客户端配置里引用同一个包或端点。

Image Downloader MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Image Downloader MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Image Downloader MCP 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

Image Downloader MCP 能提供哪些能力?

资料显示能力标签包括 格式转换、JavaScript、批量处理。具体工具清单以官方文档为准。

Image Downloader MCP 需要什么运行环境?

运行时为 Node.js;属于远程端点,不需要在本地装运行时。

Image Downloader MCP 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。