Minipainter MCP Server

What is Minipainter?

Minipainter is a local-first paint registry for miniature-painting workflows. It maintains a deterministic catalog of 1,607 paints (Citadel, Army Painter, Vallejo, AK) and a personal inventory of owned paints, enabling AI paint suggestions that understand what you actually have. It provides a colored terminal UI (TUI), CLI, and MCP servers for both Claude Desktop and ChatGPT.

How to use Minipainter?

Install with npx minipainter or globally via npm install -g minipainter. Run CLI commands like paint search, match color, or tui to interact with the catalog and inventory. For Claude Desktop, add an MCP server entry in its configuration pointing to src/mcp-server.mjs. For self‑hosted Docker, use docker compose up --build (includes Postgres) or build the image and run with a volume. The HTTP server exposes REST endpoints and an MCP transport.

Key features of Minipainter

• Owned-first matching for paint lookup and recommendations
• Local catalog (bundled) and personal inventory (JSON or Postgres)
• RGB‑aware search and cross‑brand color matching
• Colored TUI with per‑paint RGB swatches and ownership status
• Agent‑friendly CLI and MCP servers for Claude Desktop and ChatGPT
• Deterministic, version‑controlled paint IDs

Use cases of Minipainter

• Miniature painters who want AI paint suggestions based on their actual collection
• Tracking which paints you own across multiple brands
• Finding closest color matches from owned paints for a target color or description
• Integrating paint inventory into Claude Desktop workflows (search, ownership updates)