MCP Image Processor

🚀 MCP 圖像處理服務器

MCP 圖像處理服務器是一款高性能的圖像處理工具，基於 Model Context Protocol (MCP) 開發。它能提供格式轉換、尺寸調整等多種圖像處理功能，極大提升了圖像處理的效率和便捷性。

🚀 快速開始

MCP 圖像處理服務器是一款基於 Model Context Protocol (MCP) 開發的高性能圖像處理工具。它提供了豐富的圖像處理功能，如格式轉換、尺寸調整、旋轉翻轉和後處理等。以下是使用該服務器的快速入門步驟：

克隆倉庫

git clone [倉庫地址]
cd MCP-image-server

編譯代碼

npm install
npm run build

配置 MCP 服務器

編輯 package.json 文件，配置圖像處理參數（如輸入和輸出路徑）。

✨ 主要特性

• 格式轉換：支持將圖片從一種格式轉換到另一種格式（如 JPEG、PNG、WebP、AVIF 等）。
• 尺寸調整：支持圖像縮放、裁剪和拉伸，保持比例或強制指定尺寸。
• 旋轉與翻轉：支持任意角度的旋轉以及水平鏡像和垂直鏡像操作。
• 後處理效果：包括亮度、對比度、飽和度調整，模糊和銳化等效果。

📦 安裝指南

系統要求

• Node.js (版本 14.0 或以上)
• TypeScript (版本 3.9 或以上)
• sharp 圖像處理庫（用於加速圖像操作）

安裝步驟

克隆倉庫

git clone [倉庫地址]
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

感謝您使用 MCP 圖像處理服務器！歡迎貢獻代碼並提出寶貴意見！