Lets an AI client look up, find closest, and convert color codes across various craft brands like LEGO, DMC, and Perler beads.
Also known as makebead/craft-color-codes, craft-color-codes
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Sep 27, 2026
- License
- MIT
What is Craft Color Codes MCP?
Craft Color Codes lets an AI client look up, find closest, and convert color codes across various craft brands like LEGO, DMC, and Perler beads.
Summary generated from the project's README
About Craft Color Codes MCP server
Craft Color Codes provides an extensive database of 3,689 color codes across 15 different craft palettes. It is designed for developers and hobbyists who need to translate colors between specific brands like LEGO, DMC embroidery floss, Perler beads, and Minecraft blocks. The server allows an AI client to access precise hex and RGB values for materials such as Miyuki Delica beads, Hama beads, and Red Heart yarn.
Users can integrate this server into clients like Claude Desktop, Cursor, or VS Code using npx. The toolset includes specific commands such as list_palettes, get_color, find_closest, convert_color, and search_colors. It distinguishes itself by providing data reliability ratings, ranging from official game colors to community-sampled palettes, ensuring users know how much to trust the accuracy of a specific color match.
What you can do with it
- 1Convert between craft brandsAn AI can translate a specific color code from one brand to its closest equivalent in another brand.
- 2Find matching bead colorsA developer can ask for the closest Perler bead color to a specific hex code.
- 3Search for specific materialsYou can look up the exact hex and RGB values for a specific embroidery floss or bead code.
- 4Browse available palettesAn assistant can list all supported craft brands and their data accuracy status.
Written from the project's README. Every use case is checked against a quote from it.
How to install Craft Color Codes MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Craft Color Codes MCP in Claude Code
$ claude mcp add craft-color-codes -- npx -y craft-color-codesInstall Craft Color Codes MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"craft-color-codes": {
"command": "npx",
"args": [
"-y",
"craft-color-codes"
]
}
}
}Install Craft Color Codes MCP in VS Code
.vscode/mcp.json
{
"servers": {
"craft-color-codes": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"craft-color-codes"
]
}
}
}Install Craft Color Codes MCP in VS Code CLI
$ code --add-mcp '{"name":"craft-color-codes","type":"stdio","command":"npx","args":["-y","craft-color-codes"]}'Install Craft Color Codes MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"craft-color-codes": {
"command": "npx",
"args": [
"-y",
"craft-color-codes"
]
}
}
}Install Craft Color Codes MCP in Codex
$ codex mcp add craft-color-codes -- npx -y craft-color-codesInstall Craft Color Codes MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.craft-color-codes] command = "npx" args = ["-y", "craft-color-codes"]
Install Craft Color Codes MCP in Gemini CLI
$ gemini mcp add -s user craft-color-codes npx -- -y craft-color-codesInstall Craft Color Codes MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"craft-color-codes": {
"command": "npx",
"args": [
"-y",
"craft-color-codes"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablemakebead/craft-color-codes is public and reachablegithub.com/makebead/craft-color-codes ↗Pass
- Package names this repository as its sourcecraft-color-codes names makebead/craft-color-codes as sourcenpmjs.com/package/craft-color-codes ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-27github.com/makebead/craft-color-codes ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from craft-color-codesPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubCraft Color Codes
English · Deutsch · 日本語 · 한국어 · Français · Español · Русский · ไทย · 简体中文 · 繁體中文 · Português (Brasil)
Hex and RGB values for 3,689 craft color codes in 15 palettes — fuse beads, seed beads, embroidery floss, diamond painting drills, yarn, LEGO and Minecraft — with where every number comes from and how far to trust it.
MakeBead turns photos into bead, cross-stitch and pixel-art patterns. These are the palettes its tools use, published so that anyone building a pattern maker, a color converter or a shopping list does not have to collect them again, and so that a wrong color gets found and fixed in one place.
Palettes
| Palette | Colors | Status | Files | Used on MakeBead |
|---|---|---|---|---|
| Perler Beads (Midi, 5 mm) | 103 | community |
JSON · CSV | Free Perler Bead Pattern Maker |
| Hama Beads (Midi, 5 mm) | 92 | community |
JSON · CSV | Free Hama Bead Pattern Maker |
| Artkal S series (Midi, 5 mm) | 199 | community |
JSON · CSV | Free Artkal Bead Pattern Maker |
| Nabbi BioBeads (Midi) | 30 | community |
JSON · CSV | Free Fuse Bead Pattern Maker |
| MARD Beads (Midi, 5 mm) — 185 colors | 185 | community |
JSON · CSV | Free MARD Bead Pattern Maker |
| MARD Beads (Midi, 5 mm) — 221 colors | 221 | community |
JSON · CSV | Free MARD Bead Pattern Maker |
| MARD Beads (Midi, 5 mm) — 291 colors | 291 | community |
JSON · CSV | Free MARD Bead Pattern Maker |
| Miyuki Delica 11/0 (DB) | 1,288 (76 discontinued) | measured |
JSON · CSV | Free Bead Loom Pattern Maker |
| DMC Six-Strand Embroidery Floss (Mouliné Spécial, art. 117) | 489 | cross-checked |
JSON · CSV | DMC Color Chart |
| DMC-coded diamond painting drills | 154 | cross-checked |
JSON · CSV | Free Custom Diamond Painting Pattern Maker |
| LEGO brick colors (mosaic palette) | 40 | approximate |
JSON · CSV | Free LEGO Mosaic Maker |
| Minecraft blocks for pixel art | 53 | approximate |
JSON · CSV | Free Minecraft Pixel Art Generator |
| Minecraft map colors (Java Edition) | 244 | official |
JSON · CSV | Minecraft Map Art Generator |
| Red Heart Super Saver (worsted) | 44 | approximate |
JSON · CSV | Free Crochet Pattern Maker |
| Pixel art 256 | 256 | generated |
JSON · CSV | Free Pixel Art Converter |
MARD retail boxes (24 → 264 colors: which codes each box holds) are in data/sets/mard-kits.json.
How far to trust a palette
official— the maker or the game publishes these numbers, and ours match themmeasured— measured from the maker's own material by a documented methodcross-checked— several independent sources compared, conflicts settled by a written rulecommunity— sampled from physical beads or photos by hobbyists, not independently checkedapproximate— codes and names checked, colors not yet calibratedgenerated— not a product line
No screen shows a physical bead exactly: finish, lighting and monitor all move it. Use the hex to choose and compare, and buy by the code.
Use it
Download or link the files
Every palette is a JSON file and a CSV file. Link them straight from a CDN:
https://cdn.jsdelivr.net/gh/makebead/craft-color-codes@main/data/json/dmc-floss.json
https://cdn.jsdelivr.net/npm/craft-color-codes@1/data/csv/miyuki-delica.csv
JavaScript
Look up codes, find the closest color, convert between brands. No dependencies.
npm install craft-color-codes
import { getColor, nearest, convert } from 'craft-color-codes';
getColor('delica', 'DB10'); // "DB10", "DB-010" and "10" all work
// → { code: 'DB0010', name: 'Opaque Black', hex: '#131313' }
nearest('#E8A0B0', 'dmc', { limit: 3 }); // closest DMC floss to a color
// → [{ code: '3354', name: 'Dusty Rose Light', hex: '#E4A6AC', deltaE: 3.62 }, …]
convert('perler', 'P38', 'hama'); // Perler P38 → Hama
// → { from: { code: 'P38', name: 'Magenta', … }, matches: [{ code: 'H32', name: 'Neon Fuchsia', hex: '#FF208D', deltaE: 4.81 }, …] }
MCP server (Claude, Cursor, VS Code…)
Give an AI assistant the palettes as tools, so it answers "what is Perler P38 in Hama?" or "which DMC floss is closest to #E8A0B0?" from the data instead of from memory.
Claude Code:
claude mcp add craft-color-codes -- npx -y craft-color-codes
Other clients (Claude Desktop, Cursor, VS Code):
{
"mcpServers": {
"craft-color-codes": {
"command": "npx",
"args": [
"-y",
"craft-color-codes"
]
}
}
}
list_palettes— every palette, with its statusget_color— one color by its code, written the way people write itfind_closest— closest colors to a hex color, ranked by CIEDE2000convert_color— a code in one brand → its closest equivalents in anothersearch_colors— search by color name or code
Data format
Each palette file carries its own description, sources and license:
{
"id": "miyuki-delica",
"brand": "Miyuki",
"product": "Miyuki Delica 11/0 (DB)",
"count": 1288,
"status": "measured",
"notes": "…", "sources": [ … ], "license": "CC-BY-4.0",
"colors": [
{"code":"DB0010","name":"Opaque Black","hex":"#131313","rgb":[19,19,19],"glass":"opaque"},
…
]
}
code— as printed on the bag, tube, skein or itemhex—#RRGGBB, upper case, withrgbas[r, g, b]discontinued—trueonly for colors no longer made (Miyuki Delica)- palette-specific fields:
sku(Perler item number),glass(Delica glass type),group,block,survival(Minecraft blocks),base,shade,buildable(Minecraft map colors)
The CSV has the same colors, one per row:
code,name,hex,r,g,b,discontinued,glass
DB0010,Opaque Black,#131313,19,19,19,false,opaque
Where the numbers come from
Each palette's sources, method and known weaknesses are in SOURCES.md and in the palette file's notes. Two examples of what that checking found: DMC 309 (Rose Dark) is grey-brown in the common upstream data and red here, and the Delica colors were rebuilt from Miyuki's own photos after MakeBead's earlier 39-color set turned out to draw DB0724, an opaque green, as red.
Found a wrong color?
Open an issue with the palette, the code, what you see — and if you can, a daylight photo of the bead, skein or brick next to white paper. Corrections go into MakeBead first and are republished here.
License
Code (src/, bin/): MIT. Data (data/): CC BY 4.0 — use it anywhere, commercial use included, with a credit. The Perler, Hama, Artkal and Nabbi values come from maxcleme/beadcolors and stay under its MIT license. Suggested credit:
Color data: craft-color-codes by MakeBead (https://makebead.com)
Perler, Hama, Artkal, Nabbi, MARD, Miyuki, Delica, DMC, Red Heart, LEGO and Minecraft are trademarks of their owners. This project is not affiliated with or endorsed by any of them. NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.
About MakeBead
MakeBead is a free pattern maker for Perler and Hama beads, cross stitch, diamond painting, loom beading, crochet, LEGO mosaics and Minecraft pixel art, in 11 languages. Every palette here is live in its tools.
Craft Color Codes MCP questions
How do I add Craft Color Codes MCP to Claude Code?
Run claude mcp add craft-color-codes -- npx -y craft-color-codes in your terminal. Add --scope user to make it available in every project.
How do I add Craft Color Codes MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What kind of color palettes are available?
The server includes palettes for fuse beads, seed beads, embroidery floss, diamond painting drills, yarn, LEGO, and Minecraft.
Can I convert colors between different brands?
Yes, the server allows you to convert a code from one brand to its closest equivalents in another brand.