MCP Image Downloader

Provides image download and optimization capabilities: fetches images by URL and creates optimized variants with resizing, format conversion, and quality adjustments.

javascript

16

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can download and optimize images using a dedicated MCP server that handles image retrieval from URLs, resizes while preserving aspect ratio, adjusts quality, and converts formats. This server streamlines image preparation for AI assistants and workflows that require ready-to-use images.

How to use

Use an MCP client to invoke two core capabilities: download an image from a URL to a local path, and create an optimized version of an existing image. First, request the image through download_image with the source URL and the destination path. Then run optimize_image to produce a resized and/or quality-graded version at your chosen output path. You can specify width or height to maintain aspect ratio when resizing, and adjust quality to balance file size and visual fidelity. If you need a different format, you can convert the image during optimization.

For practical workflows, chain the tools so you download once and reuse the downloaded image for multiple optimized variants. Ensure the destination paths are writable by your environment and that your client has permission to access the running MCP server if you are using a remote setup.

How to install

Prerequisites you need before installing this server are Node.js version 16 or higher and a compatible package manager such as npm.

# 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

Configuration and starting point

Once built, you start or connect to the MCP server via a local stdio command. The following config shows how the server can be exposed to an MCP client.

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

Available tools

download_image

Downloads an image from a URL and saves it to a specified output path.

optimize_image

Creates an optimized version of an image with optional width, height, and quality parameters to control size and fidelity.