MCP.Market

minipainter MCP server

by ArturSkowronski·io.github.ArturSkowronski/minipainter·v0.7.3
No reviews yet

Local-first miniature-paint inventory and cross-brand color matching for AI agents.

A88/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
New

0 stars47 downloads/wk

Reviews

Write one

Nobody has reviewed minipainter yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

minipainter tools (9)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • fetch

    Fetch the full record for one paint by its id (e.g. "citadel/nuln-oil").

  • inventory_list

    List owned paints from the local inventory.

  • inventory_mark_owned

    Mark a paint as owned in the local inventory.

  • inventory_mark_unowned

    Mark a paint as not owned in the local inventory.

  • match_color

    Find paints closest to a target color, owned-first, by hex or RGB.

  • match_describe

    Match paints from a semantic description like bone or silver metallic.

  • paint_search

    Search paints by name, alias, provider, owned state, role, or color family.

  • paint_show

    Show one paint or return ambiguous/not_found resolution results.

  • search

    Search the miniature-paint catalog by name, alias, color family, or usage role.

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings
  • Code scan47 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 35 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How minipainter compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 75% of 48,255 servers
Tools
9
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
47
more than 39% of 12,191 servers with a package

What its tools let an agent do: 9 read

Install minipainter in Claude Code, Cursor or VS Code

Runs npx -y minipainter on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add minipainter -- npx -y minipainter
Add to Cursor

What the publisher says

From the minipainter repository's README, as published. We do not edit it. Read it on GitHub

MINIPAINTER

The paint bench, indexed.

Site: arturskowronski.github.io/minipainter

minipainter is a local-first paint registry for miniature-painting workflows. It exists for one practical reason: AI paint suggestions are much more useful when they understand the paints you actually own.

The project gives you:

  • a deterministic local catalog (1,607 paints across Citadel, Army Painter, Vallejo, AK) and inventory
  • owned-first paint lookup and cross-brand color matching
  • a colored terminal UI (TUI) that shows each paint's real RGB as a swatch
  • MCP servers for both Claude Desktop and ChatGPT
  • a CLI surface designed for both humans and agent workflows

The colored TUI

The ledger TUI is a real colored terminal app: a MINIPAINTER banner, gold section frames, green OWNED / red MISSING status, and a truecolor swatch of every paint's own RGB. Color turns on for a TTY and honors NO_COLOR.

Why This Exists

Most paint advice workflows break at the same point: they recommend paints you do not have on hand.

minipainter is built to solve that exact problem:

  • keep a local record of what is in your paint rack
  • search it quickly by name, role, family, and approximate color
  • prepare a stable inventory foundation for a future AI skill that can inspect links, photos, and model images

The long-term goal is not “AI picks random colors for miniatures.” The goal is “AI reasons from your actual inventory first, then suggests stronger alternatives only when useful.”

Feature Highlights

  • Owned-first matching: lookups and recommendations can prioritize paints you already have.
  • Catalog in repo, inventory in your home: paint records live in data/catalog/; what you own lives in ~/.minipainting/inventory.json and follows you across projects.
  • RGB-aware search: approximate RGB values help with nearest-color matching.
  • Colored TUI: terminal ledger with per-paint RGB swatches and OWNED/MISSING status.
  • Agent-friendly CLI: deterministic command output for AI integration (Claude + ChatGPT MCP).

Screenshots

Hero Screen

Full-screen TUI with banner, catalog, detail panel, and command strip.

See: docs/assets/hero.txt

Search View

Filtered lookup for a semantic search like bone.

See: docs/assets/search.txt

Owned View

Inventory-only presentation focused on what is already bound to your collection.

See: docs/assets/owned.txt

CLI Flow

Representative command-line usage for search, ownership updates, and color matching.

See: docs/assets/cli.txt

Run with Docker (Postgres)

The whole stack — MCP/HTTP server plus a Postgres that stores your inventory — starts with one command. Inventory persists in a named volume, so it survives container restarts and docker compose down / recreation (only down -v wipes it).

docker compose up --build        # http://localhost:3000
  • GET /health — liveness
  • GET /api/inventory — owned paints (from Postgres)
  • POST /mcp — MCP for Claude Desktop · POST /mcp/v3 — MCP for ChatGPT (search/fetch)

Storage is selected by DATABASE_URL: set it (as docker-compose.yml does) for Postgres, leave it unset to use a local JSON inventory file (unchanged local behavior). See .env.example.

Deploy

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

minipainter: common questions

Is minipainter MCP server safe?
Yes, by our scan: it is graded A (88/100). Read the minipainter safety report
How do I install minipainter?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does minipainter need an API key?
No secret keys are declared. It reads 1 setting from the environment.
Is minipainter maintained?
The last commit was 74 days ago (2026-08-22). The latest release is v0.7.3.
How does minipainter compare with other MCP servers?
safety score 88/100 (higher than 75% of 48,255 servers); tools 9 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.