Image Process MCP Server

🚀 圖片處理 MCP 服務器

這是一個用於圖像處理的 MCP 服務器，藉助 Sharp 庫來提供豐富的圖像操作功能，能滿足多種圖片處理需求。

🚀 快速開始

MacOS/Linux 系統

{
  "mcpServers": {
    "Image Process MCP": {
      "command": "npx",
      "args": ["-y", "image-process-mcp-server"]
    }
  }
}

Windows 系統

{
  "mcpServers": {
    "Image Process MCP": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "image-process-mcp-server"]
    }
  }
}

✨ 主要特性

該服務器提供了以下實用的圖像處理工具：

1. 調整圖片尺寸 (resizeImage)：可靈活調節圖片的寬度和高度。
2. 轉換圖片格式 (convertFormat)：能將圖片轉換為不同的格式，如 jpeg、png、webp、avif、tiff、gif。
3. 裁剪圖片 (cropImage)：可精準裁剪圖片的指定區域。
4. 旋轉圖片 (rotateImage)：支持對圖片進行旋轉操作。
5. 獲取圖片信息 (getImageInfo)：能獲取圖片的基本信息，如尺寸、格式等。

📦 安裝指南

本項目依賴以下環境和庫：

• Node.js
• Sharp
• @modelcontextprotocol/sdk

請確保在使用前已正確安裝這些依賴項。

💻 使用示例

基礎用法

在 Claude 中，您可以使用以下方式調用工具：

調整圖片尺寸

請幫我將這張圖片調整為寬度 500 像素。
輸入路徑：/path/to/input.jpg
輸出路徑：/path/to/output.jpg

轉換圖片格式

請把這張 PNG 格式的圖片轉換成 JPG 格式。
輸入路徑：/path/to/input.png
輸出路徑：/path/to/output.jpg

裁剪圖片

請將這張圖片從左上角偏移 100 像素、右下角偏移 200 像素的位置裁剪出來。
輸入路徑：/path/to/input.jpg
輸出路徑：/path/to/cropped.jpg

旋轉圖片

請將這張圖片順時針旋轉 90 度。
輸入路徑：/path/to/input.jpg
輸出路徑：/path/to/rotated.jpg

獲取圖片信息

請告訴我這張圖片的詳細信息。
圖片路徑：/path/to/image.png

工具參數說明

調整圖片尺寸 (resizeImage)

{
  "input_path": "輸入圖片的路徑",
  "output_path": "輸出圖片的路徑",
  "width": 寬度（像素，可選）,
  "height": 高度（像素，可選）,
  "fit": "調整方式，選項：cover, contain, fill, inside, outside，默認為 cover"
}

轉換圖片格式 (convertFormat)

{
  "input_path": "輸入圖片的路徑",
  "output_path": "輸出圖片的路徑",
  "format": "目標格式，可選值：jpeg, png, webp, avif, tiff, gif",
  "quality": 圖片質量（1 - 100），僅適用於支持壓縮的格式，默認為 80
}

裁剪圖片 (cropImage)

{
  "input_path": "輸入圖片的路徑",
  "output_path": "輸出圖片的路徑",
  "left": 左邊緣偏移量（像素）,
  "top": 上邊緣偏移量（像素）,
  "right": 右邊緣偏移量（像素）,
  "bottom": 下邊緣偏移量（像素）
}

旋轉圖片 (rotateImage)

{
  "input_path": "輸入圖片的路徑",
  "output_path": "輸出圖片的路徑",
  "degree": 旋轉角度（順時針方向，範圍：-180 到 180 度）
}

獲取圖片信息 (getImageInfo)

{
  "input_path": "圖片的路徑"
}

📄 許可證

本項目採用 MIT 許可證。