MCP Image Processor

🚀 MCP 画像処理サーバー

MCP 画像処理サーバーは、高性能な画像処理ツールです。Model Context Protocol (MCP) をベースに開発され、画像の形式変換、サイズ調整、回転反転、後処理など、様々な画像処理機能を提供します。

🚀 クイックスタート

MCP 画像処理サーバーは、高性能な画像処理ツールです。このサーバーを使えば、画像の形式変換やサイズ調整など、様々な画像処理を行うことができます。

✨ 主な機能

• 形式変換：JPEG、PNG、WebP、AVIF など、様々な画像形式間の変換に対応しています。
• サイズ調整：画像の拡大縮小、トリミング、引き伸ばしを行い、アスペクト比を維持したり、任意のサイズに強制的に変更したりすることができます。
• 回転と反転：任意の角度で画像を回転させたり、水平方向や垂直方向に反転させたりすることができます。
• 後処理効果：明るさ、コントラスト、彩度の調整や、ぼかし、鮮鋭化などの効果を適用できます。

📦 インストール

システム要件

• Node.js (バージョン 14.0 以上)
• TypeScript (バージョン 3.9 以上)
• sharp 画像処理ライブラリ（画像操作の高速化に使用）

インストール手順

リポジトリのクローン

git clone [リポジトリのURL]
cd MCP-image-server

コードのコンパイル

npm install
npm run build

MCP サーバーの設定

package.json ファイルを編集し、画像処理のパラメータ（入力と出力のパスなど）を設定します。

💻 使用例

基本的な使用法

MCP 画像処理サーバーは、以下の主要な機能インターフェースを提供しています。

形式変換

function convertFormat(imagesPath: string[], outputFormat: string): Promise<string[]>

• 説明：指定された形式の画像ファイルを別の形式に変換します。
• パラメータ：
  • imagesPath：入力画像のパスの配列。
  • outputFormat：目標の形式（例：'jpeg'、'png'）。

サイズ調整

function resize(imagesPath: string[], width?: number, height?: number, maintainRatio = true): Promise<string[]>

• 説明：画像を拡大縮小し、アスペクト比を維持するか、任意のサイズを指定することができます。
• パラメータ：
  • imagesPath：入力画像のパスの配列。
  • width と height：目標の幅と高さ（オプション）。
  • maintainRatio：アスペクト比を維持するかどうか。デフォルトは true。

回転と反転

function rotateFlip(imagesPath: string[], rotateAngle?: number, flipHorizontal = false, flipVertical = false): Promise<string[]>

• 説明：画像を回転させたり、水平方向や垂直方向に反転させたりします。
• パラメータ：
  • imagesPath：入力画像のパスの配列。
  • rotateAngle：回転角度（-360 から 360 の範囲、オプション）。
  • flipHorizontal と flipVertical：水平方向または垂直方向に反転するかどうか。

後処理効果

function postProcess(imagesPath: string[], brightness = 0, contrast = 0, saturation = 0, blur = 0, sharpen = 0): Promise<string[]>

• 説明：画像の明るさ、コントラスト、彩度を調整し、ぼかしや鮮鋭化などの効果を適用します。
• パラメータ：
  • imagesPath：入力画像のパスの配列。
  • brightness：明るさの調整（-1 から 1 の範囲）。
  • contrast：コントラストの調整（-1 から 1 の範囲）。
  • saturation：彩度の調整（-1 から 1 の範囲）。
  • blur：ぼかし半径（ピクセル単位、オプション）。
  • sharpen：鮮鋭化の強度（0 から 100 の範囲）。

📚 ドキュメント

プロジェクト構造

MCP-image-server/
├── src/                # TypeScript ソースコード
│   └── index.ts        # メインプログラムファイル
├── dist/               # コンパイル出力ディレクトリ
│   └── index.js        # コンパイル後のメインプログラム
├── package.json        # プロジェクト設定と依存関係管理
└── tsconfig.json       # TypeScript コンパイル設定

📄 ライセンス

MIT License © 2025

ご利用いただき、ありがとうございます！コードの貢献やご意見をいただけると幸いです。