# Meltbead Craft Colors

> Meltbead Craft Colors is an open-source MCP server for design and media. Matches colors across bead, floss, yarn and LEGO palettes using CIEDE2000. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://meltbead.com
- **Repository:** https://github.com/jsspace/bead-colors-mcp
- **MCP Registry name:** io.github.jsspace/bead-colors-mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

Meltbead's server is a local color reference that works offline once installed. It bundles 19 palettes: 11 fuse bead palettes plus Miyuki Delica, DMC floss, DMC-coded diamond drills, Red Heart yarn, LEGO, Minecraft blocks, Minecraft map colors and a generated pixel-art palette.

Matching uses CIEDE2000 distance between each palette's sRGB screen reference, so smaller scores mean closer screen colors. The README is careful to say these are not physical measurements and that shades should be checked against real materials and printed product codes. Effect finishes are excluded from automatic matches unless asked for, discontinued Delica colors stay available by code, and codes are accepted case-insensitively with shorthand for Delica.

The code is MIT licensed and the color data is CC BY 4.0 with Meltbead as the credited party. It runs over stdio with npx and needs Node.js 20 or newer. No account or network request is needed after install.

## Features

- **19 craft palettes:** Fuse beads, Delica, DMC floss, yarn, LEGO and Minecraft among them.
- **Nearest-color search:** Finds closest screen references within one palette.
- **Cross-palette matching:** Gives one approximate match in each requested palette.
- **MARD kit lists:** Lists retail-box sizes and the codes each contains.
- **Offline use:** Runs locally with no account or network after install.

## Good for

- Convert a bead color to the closest DMC floss shade
- Find the nearest LEGO colour to a hex value
- Look up a MARD box and its included codes
- Plan pixel art with Minecraft block colors

## Install

### Claude Code (Terminal)

```sh
claude mcp add bead-colors-mcp -- npx -y @meltbead/bead-colors-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "bead-colors-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@meltbead/bead-colors-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bead-colors-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@meltbead/bead-colors-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "bead-colors-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@meltbead/bead-colors-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bead-colors-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@meltbead/bead-colors-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bead-colors-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@meltbead/bead-colors-mcp"
      ]
    }
  }
}
```

## Tools

- `list_palettes`: List palette IDs, materials, counts, origins, licenses, status and sources.
- `list_mard_kits`: List MARD retail-box sizes and included codes.
- `get_color`: Find a color by palette ID and code.
- `search_colors`: Search codes, names, HEX, brand or series; results are limited.
- `nearest_colors`: Find the closest screen references in one palette by CIEDE2000.
- `match_across_palettes`: Find one approximate match in each requested palette.

## FAQ

### How are matches scored?

By CIEDE2000 distance on sRGB screen values; smaller is closer.

### Are matches exact?

No. They are screen approximations, and important shades should be checked against physical materials.

### What licence applies?

Server code is MIT; the data files are CC BY 4.0 crediting Meltbead.

### What does it need?

Node.js 20 or newer.

### Is Meltbead Craft Colors free?

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

### How do I add Meltbead Craft Colors to Claude Code?

Run this command in your terminal: claude mcp add bead-colors-mcp -- npx -y @meltbead/bead-colors-mcp

### What are the best alternatives to Meltbead Craft Colors?

The closest alternatives to Meltbead Craft Colors 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.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/meltbead-craft-colors
