Imagician

Imagician - MCP 图像编辑器

一个 Model Context Protocol（MCP）服务，可执行全面的图像编辑操作，包括调整大小、格式转换、裁剪、压缩等。

功能

• 调整大小：使用多种适配选项更改图像尺寸
• 格式转换：在 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 中使用

添加到 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

从一张图像生成多种尺寸（非常适合响应式图像）。

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