image-mcp

image-mcp

A local MCP server that provides image processing tools including resizing, cropping, format conversion, compression, rotation, flipping, thumbnailing, watermarking, effects, placeholder generation, and overlaying.

Category
Visit Server

README

image-mcp

中文 | English

GitHub stars Downloads Downloads@latest License MCP

基于 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。

安装与接入（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

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured