minipainter MCP
A local-first CLI and MCP server for miniature-paint inventory and cross-brand color matching. It allows AI agents to plan painting schemes based on the user's actual owned paints, match colors across brands like Citadel and Vallejo, and manage inventory via terminal UI or API endpoints without requiring a shared service.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Plan a painting scheme from your own shelf
- Match target colors to nearest pots in each brand
- Log paints without typing by recognizing products from photos
- Search the catalog by name, role, or approximate color
Source and maintenance
- Last repository push
- Latest release
- v0.9.0
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
minipainter 0.7.3
{
"version": "0.7.3",
"transport": "stdio",
"identifier": "minipainter",
"runtimeHint": "npx",
"registryType": "npm",
"registryBaseUrl": "https://registry.npmjs.org",
"packageArguments": [
{
"type": "positional",
"value": "minipainter-mcp"
}
],
"runtimeArguments": [
{
"type": "positional",
"value": "-y"
},
{
"type": "positional",
"value": "-p"
},
{
"type": "positional",
"value": "minipainter"
}
],
"environmentVariables": [
{
"name": "INVENTORY_PATH",
"description": "Path to the inventory JSON file. Defaults to ~/.minipainting/inventory.json."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · repository · passed · metadata changed · updated
- · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"minipainter-mcp": {
"command": "npx",
"args": [
"-y",
"minipainter@0.7.3",
"minipainter-mcp"
],
"env": {
"INVENTORY_PATH": "<YOUR_INVENTORY_PATH>"
}
}
}
}Cline
{
"mcpServers": {
"minipainter-mcp": {
"command": "npx",
"args": [
"-y",
"minipainter@0.7.3",
"minipainter-mcp"
],
"env": {
"INVENTORY_PATH": "<YOUR_INVENTORY_PATH>"
}
}
}
}VS Code
{
"servers": {
"minipainter-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"minipainter@0.7.3",
"minipainter-mcp"
],
"env": {
"INVENTORY_PATH": "<YOUR_INVENTORY_PATH>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"minipainter-mcp": {
"command": "npx",
"args": [
"-y",
"minipainter@0.7.3",
"minipainter-mcp"
],
"env": {
"INVENTORY_PATH": "<YOUR_INVENTORY_PATH>"
}
}
}
}Let your agent find its tools
Find servers like minipainter MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.