Imagician

🚀 Imagician - MCP 圖像編輯器

Imagician 是一個基於模型上下文協議（MCP）的服務器，可進行全面的圖像編輯操作，包括調整大小、格式轉換、裁剪、壓縮等。

🚀 快速開始

Imagician 是一款強大的圖像編輯工具，支持多種圖像編輯操作。你可以通過以下步驟開始使用它。

✨ 主要特性

• 調整大小：通過各種適配選項更改圖像尺寸。
• 格式轉換：在 JPEG、PNG、WebP 和 AVIF 之間進行轉換。
• 裁剪：從圖像中提取特定區域。
• 壓縮：通過質量控制減小文件大小。
• 旋轉：將圖像旋轉任意角度。
• 翻轉：水平或垂直鏡像圖像。
• 批量處理：從單張圖像生成多種尺寸。
• 元數據：提取圖像信息和屬性。

📦 安裝指南

從 npm 安裝

npm install -g @flowy11/imagician

從源代碼安裝

git clone https://github.com/flowy11/imagician.git
cd imagician
npm install
npm run build

💻 使用示例

在 Claude Code 中使用

將以下內容添加到你的 Claude Code 配置文件（~/.config/claude/config/settings/mcp-servers.json）中：

{
  "imagician": {
    "command": "npx",
    "args": ["-y", "@flowy11/imagician"]
  }
}

在 Cursor 中使用

將以下內容添加到你的 Cursor 配置文件（~/.cursor/mcp_settings.json）中：

{
  "mcpServers": {
    "imagician": {
      "command": "npx",
      "args": ["-y", "@flowy11/imagician"]
    }
  }
}

在 Claude Desktop 中使用

快速使用 npx 設置（推薦）

將以下內容添加到你的 Claude Desktop 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）中：

{
  "mcpServers": {
    "imagician": {
      "command": "npx",
      "args": ["-y", "@flowy11/imagician"]
    }
  }
}

如果你通過 npm 全局安裝

{
  "mcpServers": {
    "imagician": {
      "command": "imagician"
    }
  }
}

如果你從源代碼安裝

{
  "mcpServers": {
    "imagician": {
      "command": "node",
      "args": ["/path/to/imagician/dist/index.js"]
    }
  }
}

可用工具

resize_image

將圖像調整為指定尺寸，並提供多種適配選項。

參數:
- inputPath: 輸入圖像的路徑
- outputPath: 保存調整大小後圖像的路徑
- width: 目標寬度（像素，可選）
- height: 目標高度（像素，可選）
- fit: 調整大小的方式（cover, contain, fill, inside, outside）
- preserveAspectRatio: 保持寬高比（默認值: true）

convert_format

在圖像格式之間進行轉換，並可控制質量。

參數:
- inputPath: 輸入圖像的路徑
- outputPath: 保存轉換後圖像的路徑
- format: 目標格式（jpeg, png, webp, avif）
- quality: 有損格式的質量（1 - 100，默認值: 80）

crop_image

從圖像中提取特定區域。

參數:
- inputPath: 輸入圖像的路徑
- outputPath: 保存裁剪後圖像的路徑
- left: 左偏移量（像素）
- top: 上偏移量（像素）
- width: 裁剪區域的寬度
- height: 裁剪區域的高度

compress_image

通過質量設置減小圖像文件大小。

參數:
- inputPath: 輸入圖像的路徑
- outputPath: 保存壓縮後圖像的路徑
- quality: 壓縮質量（1 - 100，默認值: 80）
- progressive: 對 JPEG 使用漸進式編碼（默認值: true）

rotate_image

將圖像旋轉任意角度。

參數:
- inputPath: 輸入圖像的路徑
- outputPath: 保存旋轉後圖像的路徑
- angle: 旋轉角度（度，正值表示順時針）
- background: 暴露區域的背景顏色（默認值: #000000）

flip_image

水平或垂直鏡像圖像。

參數:
- inputPath: 輸入圖像的路徑
- outputPath: 保存翻轉後圖像的路徑
- direction: 翻轉方向（horizontal, vertical, both）

get_image_info

提取圖像的元數據和信息。

參數:
- inputPath: 圖像文件的路徑

返回值: 格式、尺寸、色彩空間、文件大小等。

batch_resize

從一張圖像生成多種尺寸（非常適合響應式圖像）。

參數:
- inputPath: 輸入圖像的路徑
- outputDir: 保存調整大小後圖像的目錄
- sizes: {width, height?, suffix} 數組
- format: 所有尺寸的輸出格式（可選）

在 Claude 中的使用示例

"請將 image.jpg 調整為 800x600 像素"
"將 photo.png 轉換為 WebP 格式，質量為 90%"
"從 (100, 100) 開始裁剪 avatar.jpg，大小為 200x200"
"生成縮略圖尺寸：寬 150px、300px 和 600px"

🔧 技術細節

開發

# 安裝依賴
npm install

# 構建 TypeScript
npm run build

# 在開發模式下運行
npm run dev

📄 許可證

本項目採用 MIT 許可證。