mcp-image-downloader

MCP Image Downloader

An MCP server that provides tools for downloading and optimizing images. Built using the Model Context Protocol (MCP), this server enables AI assistants to download images from URLs and perform basic image optimization tasks.

Features

Download images from URLs with proper error handling
Optimize images with options for:
- Resizing (maintaining aspect ratio)
- Quality adjustment (JPEG/WebP)
- Format conversion

Installation

# Clone the repository
git clone https://github.com/qpd-v/mcp-image-downloader.git
cd mcp-image-downloader

# Install dependencies
npm install

# Build the project
npm run build

Usage

As an MCP Server

Add the server to your MCP configuration (e.g., in Claude Desktop's config):

{
  "mcpServers": {
    "image-downloader": {
      "command": "node",
      "args": ["/path/to/mcp-image-downloader/build/index.js"]
    }
  }
}

Available Tools

download_image

Downloads an image from a URL to a specified path.

Parameters:

url: URL of the image to download
outputPath: Path where to save the image

optimize_image

Creates an optimized version of an image.

Parameters:

inputPath: Path to the input image
outputPath: Path where to save the optimized image
width (optional): Target width (maintains aspect ratio if only width is specified)
height (optional): Target height (maintains aspect ratio if only height is specified)
quality (optional): JPEG/WebP quality (1-100)

Development

# Run in development mode
npm run start

# Build the project
npm run build

Requirements

Node.js 16 or higher
NPM or compatible package manager

License

MIT License - see the LICENSE file for details.

Author

qpd-v

Version

0.1.0 - Initial release

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Enables AI assistants to download images from URLs and perform basic image optimization tasks.

Related MCP Servers

Together AI Image MCP Server
stefanskiasan
A
security
A
license
A
quality
Enables the generation of images using Together AI's models through an MCP server, supporting customizable parameters such as model selection, image dimensions, and output directory.
Last updated -
1
4
JavaScript
MIT License
MCP Flux Studio
jmanhype
-
security
A
license
-
quality
A server that integrates Flux's advanced image generation and manipulation features into AI coding assistants, enabling seamless text-to-image and image control workflows in IDEs like Cursor and Windsurf.
Last updated -
4
10
Python
MIT License
OpenAI MCP
jezweb
-
security
-
license
-
quality
A Model Context Protocol server enabling AI assistants to generate images through OpenAI's DALL-E API with full support for all available options and fine-grained control.
Last updated -
JavaScript
MIT License
Image Analysis MCP Server
champierre
A
security
F
license
A
quality
A server that accepts image URLs and analyzes their content using GPT-4-turbo, enabling Claude AI assistants to understand and describe images through natural language.
Last updated -
1
1
JavaScript

View all related MCP servers

mcp-image-downloader