画像をダウンロードして最適化するためのツールを提供するMCPサーバー。 モデルコンテキストプロトコル(MCP)を使用して構築されたこのサーバーは、AIアシスタントがURLから画像をダウンロードし、基本的な画像最適化タスクを実行できるようにします。

##特徴

• 適切なエラー処理でURLから画像をダウンロード
• オプションで画像の最適化:
• 再サイズ(アスペクト比を含む) ・品質調整(JPEG/WebP)
• フォーマット変換

インストール

使用法

##MCP サーバーとして

サーバを MCP 設定に追加します。 (例: Claude Desktop の設定)

利用可能なツール

####ダウンロード image URLから指定したパスに画像をダウンロードします。

パラメーター:

• [url:画像のURLをダウンロード

####の最適化 image イメージの最適化されたバージョンを作成します。

パラメーター:

• [inputPath: 入力イメージへのパス
• [width(オプション): 対象幅(幅のみ指定の場合のアスペクト比を含む)
• [height(オプション): ターゲット高さ(高さのみ指定の場合、アスペクト比を含む)
• [quality(オプション):JPEG/WebP品質(1-100)

開発

要件

• Node.js 16以上

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