项目简介

这是一个实现了 Model Context Protocol (MCP) 的服务器，旨在为兼容 MCP 协议的客户端（如某些 AI 助手）提供强大的图像处理能力。它封装了流行的 ImageMagick 图像处理库，通过标准化的 JSON-RPC 接口暴露一系列图像操作工具。

主要功能点

图像二值化： 将彩色或灰度图像转换为仅包含黑白两色的图像，可设定转换阈值。
颜色调整： 自由调整图像的色相、亮度、饱和度，改变图片的整体色彩风格。
图像缩放： 根据指定的宽度、高度或比例因子调整图片尺寸，支持保持宽高比。
格式转换： 在多种常见的图片格式之间进行互相转换，如 PNG, JPG, BMP, TGA, WebP 等。
图像模糊： 对图片应用高斯模糊或其他模糊效果，可控制模糊的半径和强度。
灰度转换： 将彩色图像转换为黑白（灰度）图像。
信息查询： 获取图片的详细元数据和属性，包括格式、尺寸、颜色深度、文件大小等。
滤镜应用： 应用各种艺术和效果滤镜，如锐化、边缘检测、浮雕、油画、素描、波浪、漩涡等。

安装步骤

克隆仓库： 将项目的代码克隆到你的本地文件系统。

git clone https://github.com/aimino/imagemagic-mcp.git
cd imagemagic-mcp

安装依赖： 需要安装 ImageMagick 库本身以及 Python 环境和相关的包。
- 安装 ImageMagick： 根据你的操作系统进行安装。
  - Windows: 从 ImageMagick 官网下载安装程序并运行，安装时请确保勾选 "Install development headers and libraries for C and C++" 选项。
  - Linux: 使用你的包管理器安装 'imagemagick' 和开发库 'libmagickwand-dev'。例如，在 Ubuntu 上：
```
sudo apt-get update
sudo apt-get install -y imagemagick libmagickwand-dev
```
- 安装 Python 包： 确保你已安装 Python 3.8 或更高版本。然后使用 pip 安装所需的 Python 库：
```
pip install wand mcp click
```

服务器配置

要让你的 MCP 客户端（如 AI 助手）能够使用此服务器，你需要在客户端的配置目录下创建一个名为 'cline_mcp_settings.json' 的文件（如果不存在的话），并添加此服务器的配置信息。

配置文件路径：
- Windows: '%APPDATA%\cline\cline_mcp_settings.json'
- macOS/Linux: '~/.config/cline/cline_mcp_settings.json'

配置内容示例： 在 'mcpServers' 部分添加一个条目，例如命名为 '"imagemagick-mcp"'：

{
  "mcpServers": {
    "imagemagick-mcp": {
      "command": "python",
      "args": ["/path/to/your/imagemagic-mcp/imagemagick_server.py"],
      "disabled": false,
      "alwaysAllow": []
    }
    // 如果有其他 MCP 服务器，也可以在此处添加配置
  }
}

重要： 将 '/path/to/your/imagemagic-mcp' 替换为你实际克隆 'imagemagic-mcp' 仓库的绝对路径。

'"imagemagick-mcp"': 这个名字是你给服务器起的唯一标识，客户端会使用这个名字来引用它。
'"command"': 客户端用来启动服务器进程的可执行文件名，这里是 'python'。
'"args"': 启动命令的参数列表，第一个参数是服务器脚本 'imagemagick_server.py' 的完整路径。
'"disabled"': 如果设置为 'true'，则禁用此服务器。'false' 表示启用。
'"alwaysAllow"': 一个列表，包含总是允许连接到此服务器的客户端 ID。通常留空即可。

基本使用方法

完成上述安装和服务器配置。

启动 ImageMagick MCP 服务器。你可以在终端中手动运行服务器脚本：

python /path/to/your/imagemagic-mcp/imagemagick_server.py

服务器将启动并等待 MCP 客户端通过标准输入/输出连接。

打开配置好的 MCP 客户端（例如兼容 MCP 的 AI 助手）。客户端应该能够发现并连接到正在运行的 ImageMagick MCP 服务器。
在客户端界面中，你可以通过与 AI 助手交互，请求执行图像处理任务。例如，你可以说：“使用 imagemagick-mcp 工具帮我把 '/home/user/pictures/photo.jpg' 图片变成灰度图” 或者 “调用 imagemagick-mcp 的 resize 功能，把 '/data/image.png' 缩放到宽度 800 像素”。客户端将根据你的请求调用服务器提供的相应工具。
服务器执行完图像处理后，会将处理结果（通常是处理后图片的新路径）通过 MCP 协议返回给客户端，客户端会根据返回的信息进行后续操作或向你展示结果。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息