Craft Color Codes

What the Craft Color Codes MCP server does

Craft Color Codes MCP server makes structured color data available to an AI assistant through the Model Context Protocol. The underlying collection contains 3,689 colors across 15 palettes, including fuse beads, seed beads, embroidery floss, diamond-painting drills, yarn, LEGO brick colors, Minecraft blocks and map colors, and a generated pixel-art palette.

Each color can include a product code, name, hexadecimal value, RGB values, and palette-specific fields. The data also records the confidence status of each palette, such as official, measured, cross-checked, community, approximate, or generated. This distinction matters when an agent recommends a physical material: screen colors are reference values, not exact representations of beads, thread, yarn, bricks, or blocks.

How it works

The package runs as a local MCP process through npx -y craft-color-codes. An MCP client starts that process and exposes its data operations to an AI assistant. No API key or external service is described in the provided setup instructions.

The server offers five tools:

• list_palettes returns the available palettes and their status.
• get_color finds a color by the code a user provides, including accepted variations such as different formatting of a Delica code.
• find_closest ranks palette colors against a supplied hex value using the CIEDE2000 color-difference method.
• convert_color finds close equivalents for a color code in another brand or palette.
• search_colors searches palette names and codes.

For example, an assistant can identify a Perler color, find a nearby DMC floss color for a hex value, or compare a Perler code with its closest Hama equivalents. The results come from the published palette files rather than from the model's remembered color knowledge.

Setup and configuration

Install the package through the MCP client's standard server configuration. Claude Code uses:

claude mcp add craft-color-codes -- npx -y craft-color-codes

For Claude Desktop, Cursor, and VS Code, add a server entry with npx as the command and -y, followed by craft-color-codes, as its arguments:

{
  "mcpServers": {
    "craft-color-codes": {
      "command": "npx",
      "args": ["-y", "craft-color-codes"]
    }
  }
}

The package can also be used outside MCP through its JavaScript API, but that is separate from the server configuration.

Tools and capabilities

Craft Color Codes MCP server is suited to assistants that need exact product codes alongside approximate visual matching. It can cover conversions between supported palettes and return the closest available choices rather than claiming that two products are identical. Palette metadata includes sources, notes, licensing information, and known limitations in the underlying files.

The repository publishes both JSON and CSV versions of every palette. The server is therefore useful for interactive questions, while developers building their own tooling can use the package or link directly to the published data files.

Limitations and notes

Palette reliability varies. Miyuki Delica values are marked measured, DMC floss and DMC-coded diamond drills are cross-checked, Minecraft map colors are official, and several bead, LEGO, yarn, and Minecraft block palettes are community-sampled or approximate. Pixel art 256 is generated rather than a product line.

A closest-color result is not a guarantee of a physical match. Lighting, material finish, photography, and monitor settings affect appearance, so the repository recommends using hexadecimal values for comparison and purchasing by the manufacturer’s code. Some palette entries may also be discontinued, including 76 Miyuki Delica colors identified in the palette listing.

The code is MIT licensed. The main data is CC BY 4.0, with separate licensing noted for values originating from the beadcolors project. Developers distributing the data should review the repository’s attribution guidance.