Imagician

Imagician - MCP 画像エディター

リサイズ、形式変換、トリミング、圧縮など、幅広い画像編集操作に対応する Model Context Protocol（MCP）サーバーです。

機能

• リサイズ：さまざまなフィットオプションで画像の寸法を変更します
• 形式変換：JPEG、PNG、WebP、AVIF 間で変換します
• トリミング：画像から特定の領域を切り出します
• 圧縮：画質を調整してファイルサイズを削減します
• 回転：画像を任意の角度で回転します
• 反転：画像を水平方向または垂直方向に反転します
• 一括処理：1 枚の画像から複数のサイズを生成します
• メタデータ：画像の情報とプロパティを抽出します

インストール

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 での使用方法

Claude Desktop の設定に追加します（~/Library/Application Support/Claude/claude_desktop_config.json）：

npx を使用した簡単なセットアップ（推奨）：

{
  "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

さまざまなフィットオプションを使って、指定した寸法に画像をリサイズします。

Parameters:
- inputPath: Path to input image
- outputPath: Path to save resized image
- width: Target width in pixels (optional)
- height: Target height in pixels (optional)
- fit: How to resize (cover, contain, fill, inside, outside)
- preserveAspectRatio: Maintain aspect ratio (default: true)

convert_format

画質を調整して、画像形式を変換します。

Parameters:
- inputPath: Path to input image
- outputPath: Path to save converted image
- format: Target format (jpeg, png, webp, avif)
- quality: Quality for lossy formats (1-100, default: 80)

crop_image

画像から特定の領域を切り出します。

Parameters:
- inputPath: Path to input image
- outputPath: Path to save cropped image
- left: Left offset in pixels
- top: Top offset in pixels
- width: Width of crop area
- height: Height of crop area

compress_image

画質設定を使って、画像ファイルのサイズを削減します。

Parameters:
- inputPath: Path to input image
- outputPath: Path to save compressed image
- quality: Compression quality (1-100, default: 80)
- progressive: Use progressive encoding for JPEG (default: true)

rotate_image

画像を任意の角度で回転します。

Parameters:
- inputPath: Path to input image
- outputPath: Path to save rotated image
- angle: Rotation angle in degrees (positive = clockwise)
- background: Background color for exposed areas (default: #000000)

flip_image

画像を水平方向または垂直方向に反転します。

Parameters:
- inputPath: Path to input image
- outputPath: Path to save flipped image
- direction: Flip direction (horizontal, vertical, both)

get_image_info

画像のメタデータと情報を抽出します。

Parameters:
- inputPath: Path to image file

Returns: format, dimensions, color space, file size, etc.

batch_resize

1 枚の画像から複数のサイズを生成します（レスポンシブ画像に最適です）。

Parameters:
- inputPath: Path to input image
- outputDir: Directory to save resized images
- sizes: Array of {width, height?, suffix}
- format: Output format for all sizes (optional)

Claude での使用例

"Please resize image.jpg to 800x600 pixels"
"Convert photo.png to WebP format with 90% quality"
"Crop avatar.jpg starting at (100, 100) with 200x200 size"
"Generate thumbnail sizes: 150px, 300px, and 600px wide"

開発

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

ライセンス

MIT