# Craft Color Codes

> Craft Color Codes is an open-source MCP server for design and media. Look up, match and convert craft color codes for beads, floss, yarn, LEGO and Minecraft. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://makebead.com
- **Repository:** https://github.com/makebead/craft-color-codes
- **MCP Registry name:** io.github.makebead/craft-color-codes
- **Categories:** design and media, games and play
- **Listing updated:** 2026-11-16

## About

This package serves a dataset of 3,689 colour codes across 15 palettes, published by the makers of a bead pattern site so that anyone building a pattern maker, colour converter or shopping list does not need to gather the colours again. Palettes include Perler, Hama, Artkal S, Nabbi and MARD beads, Miyuki Delica seed beads, DMC embroidery floss and diamond-painting drills, LEGO brick colours, Minecraft blocks and map colours, and Red Heart yarn.

Each palette carries a status describing how far to trust it: official, measured, cross-checked, community or approximate. Minecraft map colours are marked official, while LEGO and the Minecraft block palette are approximate. The registry entry says the server looks up codes, finds the closest match to a colour and converts between brands.

It runs locally over stdio from npm. The code is under one licence and the colour data under a separate data licence.

## Features

- **3,689 colour codes:** Hex and RGB values across 15 palettes.
- **Brand conversion:** Maps a colour in one brand to the closest in another.
- **Closest-colour match:** Finds the nearest code to any colour.
- **Trust status:** Labels each palette as official, measured, cross-checked, community or approximate.
- **Many crafts:** Spans beads, floss, yarn, diamond painting, LEGO and Minecraft.
- **JSON and CSV data:** Publishes every palette in both formats.

## Good for

- Find the nearest Hama bead for a Perler colour
- Convert a DMC floss colour to a diamond-painting drill
- Build a shopping list for a pixel-art pattern
- Match an image colour to LEGO or Minecraft blocks

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "craft-color-codes": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "craft-color-codes"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## FAQ

### How many colours are included?

3,689 codes in 15 palettes.

### How reliable are the values?

Each palette is labelled official, measured, cross-checked, community or approximate.

### How is it installed?

As the craft-color-codes npm package, running locally over stdio.

### Which brands are covered?

Perler, Hama, Artkal, Nabbi, MARD, Miyuki Delica, DMC, LEGO, Minecraft and Red Heart, among others.

### Is Craft Color Codes free?

Yes. Craft Color Codes is open source, so you can use and self-host it for free.

### How do I add Craft Color Codes to Claude Code?

Run this command in your terminal: claude mcp add craft-color-codes -- npx -y craft-color-codes

### What are the best alternatives to Craft Color Codes?

The closest alternatives to Craft Color Codes are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/craft-color-codes
