Image Download And Optimize

🚀 MCP Image Downloader

A server based on the Model Context Protocol (MCP) that provides tools for downloading and optimizing images. This server, built with Node.js, enables AI assistants to download images from URLs and perform basic image optimization tasks.

🚀 Quick Start

This MCP Image Downloader is a Node.js-based server that allows AI assistants to download images from URLs and perform basic image optimization tasks.

✨ Features

• Download images from the internet via URLs with proper error handling.
• Offer the following optimization options:
  • Resize (while maintaining aspect ratio).
  • Adjust quality (for JPEG/WebP).
  • Convert formats.

📦 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 Examples

As an MCP Server

Add the server to your MCP configuration (e.g., in the configuration file of Claude Desktop):

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

Available Tools

download_image

Download an image from a URL and save it to the specified path.

Parameters:

• url: The URL of the image to be downloaded.
• outputPath: The target path to save the image.

optimize_image

Generate an optimized version of the image based on the specified parameters.

Parameters:

• inputPath: The path of the input image.
• outputPath: The path to save the optimized image.
• width (optional): The target width (while maintaining the aspect ratio if only the width is specified).
• height (optional): The target height (while maintaining the aspect ratio if only the height is specified).
• quality (optional): JPEG/WebP quality (1 - 100).

🔧 Technical Details

Development

# Run in development mode
npm run start

# Build the project
npm run build

Requirements

• Node.js 16 or higher.
• NPM or a compatible package manager.

📄 License

This project is under the MIT License. For more details, please refer to the LICENSE file.

👨‍💻 Author

qpd-v

🔖 Version

0.1.0 - Initial release