Skip to content
MCP server

Meltbead Craft Colors

Matches colors across bead, floss, yarn and LEGO palettes using CIEDE2000

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About Meltbead Craft Colors

Meltbead Craft Colors is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "bead-colors-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@meltbead/bead-colors-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "bead-colors-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@meltbead/bead-colors-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Code MIT, data CC BY 4.0

Prices change. Check meltbead.com before you buy.

Meltbead Craft Colors 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 to Meltbead Craft Colors

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. Eikino

    MCP server

    Estimate where photos or video frames were taken and check media for AI generation

    • 3 tools
    • Remote
    • Freemium
    • Security