本地图片工坊 TOBYCAI/image-mcp

image-mcp

本地图片处理 MCP Server，基于 Pillow，离线运行，不需要 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）

image-mcp MCP server

质量分由 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 后，智能体即可调用 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