mcp-pix-tools

mcp-pix-tools

Programmatic image generation MCP tools — barcodes, word clouds, palettes, charts & more. Zero AI cost.

Documentation · 繁體中文

What is this?

An MCP (Model Context Protocol) server that provides programmatic image generation tools to any LLM. No AI image generation — just fast, deterministic, code-driven visuals.

Highlights

• 7 tools — barcodes (15+ types), ISBN, word clouds, color palettes, placeholders, identicons, charts
• Dual transport — stdio for local clients, Streamable HTTP for remote/Docker
• PNG + SVG — all tools output base64 PNG or SVG text
• Zero canvas dependency — no native canvas module required
• CJK ready — Docker image includes CJK fonts for word clouds and charts

Available Tools

Tool	Description
generate_barcode	QR Code, Code128, EAN-13, EAN-8, DataMatrix, PDF417, and more
generate_isbn	ISBN-10/13 barcode with validation and format conversion
generate_wordcloud	Word cloud from weighted word lists
generate_palette	Color palettes using color theory (complementary, analogous, triadic, etc.)
generate_placeholder	Placeholder images for wireframes and mockups
generate_identicon	Unique geometric avatars from hash strings
generate_chart	Bar, pie, and line charts from data

Quick Start

npx (no install)

npx mcp-pix-tools

Global install

npm install -g mcp-pix-tools
mcp-pix-tools

HTTP mode (for remote/Docker deployment)

mcp-pix-tools --transport http --port 3100

MCP Client Configuration

Add the following JSON to your client's MCP config file:

{
  "mcpServers": {
    "pix-tools": {
      "command": "npx",
      "args": ["-y", "mcp-pix-tools"]
    }
  }
}

Client	Config file
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json (macOS) · %APPDATA%\Claude\claude_desktop_config.json (Windows)
Cursor	~/.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
Cline (VS Code)	Cline panel → MCP Servers → cline_mcp_settings.json

Claude Code:

claude mcp add pix-tools -- npx -y mcp-pix-tools

HTTP (remote/Docker):

{
  "url": "http://localhost:3100/mcp",
  "transport": "streamable-http"
}

Docker

GHCR (recommended)

docker pull ghcr.io/supra126/mcp-pix-tools:latest
docker run -p 3100:3100 ghcr.io/supra126/mcp-pix-tools:latest

Docker Compose

docker compose up -d

Build locally

docker build -t mcp-pix-tools .
docker run -p 3100:3100 mcp-pix-tools

Tool Examples

generate_barcode — QR Code

{
  "type": "qrcode",
  "text": "https://example.com",
  "format": "png",
  "scale": 5
}

generate_isbn — ISBN-13 barcode

{
  "isbn": "9780134685991",
  "format": "png"
}

generate_wordcloud — Word cloud

{
  "words": [
    { "text": "TypeScript", "weight": 100 },
    { "text": "JavaScript", "weight": 80 },
    { "text": "Node.js", "weight": 60 },
    { "text": "MCP", "weight": 90 }
  ],
  "colorScheme": "ocean",
  "format": "png"
}

generate_palette — Triadic color palette

{
  "baseColor": "#3498db",
  "scheme": "triadic",
  "count": 6,
  "format": "png"
}

generate_placeholder — Placeholder image

{
  "width": 800,
  "height": 600,
  "bgColor": "e0e0e0",
  "text": "Hero Image",
  "format": "png"
}

generate_identicon — Geometric avatar

{
  "value": "[e-mail]",
  "size": 256,
  "format": "png"
}

generate_chart — Pie chart

{
  "type": "pie",
  "data": [
    { "label": "Chrome", "value": 65 },
    { "label": "Firefox", "value": 15 },
    { "label": "Safari", "value": 12 },
    { "label": "Other", "value": 8 }
  ],
  "title": "Browser Market Share",
  "format": "png"
}

Development

git clone https://github.com/supra126/mcp-pix-tools.git
cd mcp-pix-tools
npm install
npm run build
npm test
npm run lint

License

MIT