image-mcp

中文 | English

A local image processing MCP Server based on Pillow (offline, no API key required). It exposes a set of image tools to DeepSeek Harness (or other stdio MCP-compatible clients) via MCP: info / resize / crop / convert / compress / rotate / flip / thumbnail / watermark / effects / placeholder / overlay — 12 tools in total, visible to the model as mcp__images__*.

Features

• Offline & zero cost: Pure local Pillow processing, no online API/keys needed.

• 12 image tools: info / resize / crop / convert / compress / rotate / flip / thumbnail / watermark / effects / placeholder / overlay.

• Standard protocol: JSON-RPC 2.0, line-delimited stdio MCP; all logs go to stderr (stdout is reserved for the protocol).

• Easy integration: Plug into a DSH profile with a one-line config via @deepseek-ai/dsh-mcp-client.

Related MCP server: media-mcp

Installation & Integration (DSH)

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

Add the following to your DSH profile patch (e.g. 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']

After restarting DSH, the agent can call the mcp__images__* tools.

Standalone Run (without DSH)

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

Tools Overview

Protocol

• Transport: stdio, one JSON object per line.

• Version: JSON-RPC 2.0, Protocol 2025-03-26.

• SERVER_NAME=dsh-image-mcp, SERVER_VERSION=0.1.0.

License

MIT © TOBYCAI