AI导哈

图像处理MCP服务器

一个基于ImageMagick的MCP服务器，为AI助手提供图像裁剪、调整大小和模糊填充背景的功能。

  • by artschekoff
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 artschekoff/imagemagick-mcp

使用说明

🪄 ImageMagick MCP服务器

给你的人工智能助手一双手，用于图像裁剪、调整大小和模糊填充背景。

微小而迅速 主控程序 包装服务器 ImageMagick 因此，任何感知MCP的代理（Claude、Cursor等）都可以将图像重新构建到精确的尺寸，而不会扭曲它们。

问题

你让你的人工智能助手“为OG卡制作1200×630的图像。”它可以 描述 这些步骤，但它实际上无法运行ImageMagick——所以你最终只能复制粘贴 magick 咒语你自己。还有天真的命令(-resize 1200x630!) 伸展 图像变得一团糟。

现实世界的重构很烦人，因为：

  • 纵横比从不匹配。 将4:3的照片放入16:9的插槽中会留下难看的缝隙，或者迫使扭曲的拉伸。
  • 裁剪会失去内容。 填充的作物是干净的，但它可能会切断主题。
  • 信箱看起来死了。 纯黑色的酒吧尖叫着“我放弃了”
  • 这些命令很神秘。 +clone, -extent, -gravity, -composite…没人记得这些。

解决方案

一个MCP工具-- crop_resize_blur_bg --它在保持整个图像的同时达到了精确的尺寸，为您选择了正确的策略：

模式 你得到什么 最适合
🌫️ blur （默认） 图像安装在 模糊、放大的自身副本 --完美填补空白，没有死角 缩略图、英雄卡片、社交帖子
✂️ cover 裁剪以填充，居中——无填充，无条形 化身、瓷砖、固定网格画廊
📦 contain 内部采用干净的黑色填充物 徽标、截图、无法裁剪的艺术品

当源已经与目标比率匹配时，它只会干净地调整大小。从来没有失真。

上面的横幅被生成，然后被压缩 从1.4 MB到61 KB --通过这个精确的工具。

⚡ 快速开始

# 1. Build the binary
make build        # → bin/imagemagick-mcp

# 2. Register it with your MCP client (see below)

使用克劳德代码注册

claude mcp add imagemagick -- /absolute/path/to/bin/imagemagick-mcp

手动注册（任何MCP客户端）

{
  "mcpServers": {
    "imagemagick": {
      "command": "/absolute/path/to/bin/imagemagick-mcp"
    }
  }
}

然后问： “调整大小 ~/photo.jpg 到1200×630并保存到 ~/og.jpg."

📋 需求

  • 转到1.22+ --构建服务器
  • ImageMagick 7 --the magick 二进制文件必须在您的 PATH
Installing ImageMagick

macOS

brew install imagemagick

Ubuntu/Debian

sudo apt update && sudo apt install imagemagick

Fedora/RHEL/CentOS

sudo dnf install imagemagick

Arch Linux

sudo pacman -S imagemagick

视窗 --从下载安装程序 imagemagick.org/script/download.php 然后滴答作响 “将应用程序目录添加到系统路径”。或者：

choco install imagemagick      # Chocolatey
winget install ImageMagick.ImageMagick   # Winget

验证：

magick --version

🛠️ MCP工具： crop_resize_blur_bg

将图像调整大小/裁剪到精确的尺寸。如果纵横比不同，请选择如何处理间隙 mode.

参数 类型 必填 默认 说明
input_path string ✅ — 源图像的绝对路径
output_path string ✅ — 输出的绝对路径（父目录自动创建）
width 编号 ✅ — 目标宽度（像素）
height 编号 ✅ — 目标高度（像素）
mode string -- blur blur, cover，或 contain
blur 编号 -- 30 模糊半径（由使用 blur 仅模式）

第二工具， describe_imagemagick_interface，返回用于发现的服务器元数据。

🔧 生成文件目标

目标 描述
make build 为当前平台构建→ bin/imagemagick-mcp
make build-all 达尔文/linux/windows交叉编译（amd64+arm64）
make pack 交叉编译+归档为 bin/dist/
make test 运行所有测试
make install 构建并复制二进制文件到 /usr/local/bin
make clean 删除 bin/
make release Bump版本、标记、推送、打包和发布GitHub版本（需要 gh)

发布

make release

交互式——提示 major, minor，或 patch bump，然后自动标记、推送和发布GitHub版本。

由Go+ImageMagick构建 roxl.net

相关 MCP