English Français العربية

Image MCP

Community Media and design

Offline image processing: resize, crop, convert, compress, rotate, flip, thumbnails, watermarks, effects, placeholders and overlays.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. image-mcp
  2. 特性
  3. 质量评分（Glama）
  4. 安装与接入（DSH）
  5. 独立运行（无 DSH）
  6. 工具一览
  7. 协议
  8. 适配系统
  9. License

image-mcp

中文 | English

基于 Pillow 的本地图片处理 MCP Server（离线、无需 API key）。通过 MCP 暴露一组图片工具给 DeepSeek Harness（或其他支持 stdio MCP 的客户端）：info / resize / crop / convert / compress / rotate / flip / thumbnail / watermark / effects / placeholder / overlay，共 12 个工具，模型可见工具名为 mcp__images__*。

特性

  • 离线零成本：纯本地 Pillow 处理，不需要任何线上 API/密钥。
  • 12 个图片工具：信息 / 缩放 / 裁剪 / 转换 / 压缩 / 旋转 / 翻转 / 缩略图 / 水印 / 特效 / 占位图 / 叠加。
  • 协议标准：JSON-RPC 2.0、按行分隔的 stdio MCP；所有日志走 stderr（stdout 专用于协议）。
  • 易于接入：经 @deepseek-ai/dsh-mcp-client 一行配置即可挂进 DSH profile。

质量评分（Glama）

质量分由 Glama 自动评估（TDQS 70% + Coherence 30%），出分后徽章自动显示等级。

安装与接入（DSH）

pip install -r requirements.txt   # 或 pip install Pillow

在 DSH profile 的补丁（如 cordis.patch.yml）里加入：

- id: mcp-images
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: images
    transport: stdio
    command: python3
    args: ['<PATH-TO>/image_mcp.py']

重启 DSH 后，agent 即可调用 mcp__images__* 工具。

独立运行（无 DSH）

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | python3 image_mcp.py
# 返回 12 个工具的 schema

工具一览

工具说明
info查看图片格式 / 尺寸 / 模式 / 大小
resize按宽高/比例缩放（contain / cover / fill / stretch）
crop裁剪矩形区域
convert转换格式（PNG/JPEG/WEBP/GIF/BMP/TIFF）
compress按质量重新编码压缩
rotate旋转（可扩展画布）
flip水平/垂直镜像
thumbnail长边不超过指定尺寸的缩略图
watermark文字水印（位置/颜色/透明度/字号）
effects特效：灰度/棕褐/反相/模糊/锐化/对比/亮度
placeholder生成纯色占位图（可带文字）
overlay在底图上叠加另一张图（支持透明度）

协议

  • 传输：stdio，一行一个 JSON 对象。
  • 版本：JSON-RPC 2.0，Protocol 2025-03-26。
  • SERVER_NAME=dsh-image-mcp，SERVER_VERSION=0.1.0。

适配系统

  • 适配系统：macOS / Windows / Linux（Python 3 + Pillow，跨平台）。
  • Windows 注意：命令用 python（而非 python3）；args 里的路径用绝对路径或反斜杠。

License

MIT © TOBYCAI

Frequently asked questions

What is Image MCP?

Offline image processing: resize, crop, convert, compress, rotate, flip, thumbnails, watermarks, effects, placeholders and overlays.

How do I install Image MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Image MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Image MCP?

It is published by TOBYCAI. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.