Skip to content
Back to search

bead-colors-mcp

A local MCP server for craft color charts and approximate screen-color matching.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jsspace--bead-colors-mcp/badge.svg)](/listings/jsspace--bead-colors-mcp)

HTML

<a href="/listings/jsspace--bead-colors-mcp"><img src="/api/listings/jsspace--bead-colors-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx -y @meltbead/bead-colors-mcp

The server uses stdio: an MCP client launches it and communicates through stdin/stdout. Starting it in a terminal will appear idle until a client connects. Add this configuration to an MCP client:

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

Package: [@meltbead/bead-colors-mcp on npm](https://www.npmjs.com/package/@meltbead/bead-colors-mcp).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 62 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Craft Colors MCP
  2. A local MCP server for craft color charts and approximate screen-color matching. It combines the existing [`@meltbead/bead-colors`](https://github.com/jsspace/bead-colors) fuse bead references with eight locally bundled palettes distributed by [Meltbead](https://meltbead.com/) under direct authorization. No account or network request is needed after installation.
  3. ## Requirements
  4. Node.js 20 or newer.
  5. ## Install from npm
  6. ```sh
  7. npx -y @meltbead/bead-colors-mcp
  8. ```
  9. The server uses stdio: an MCP client launches it and communicates through stdin/stdout. Starting it in a terminal will appear idle until a client connects. Add this configuration to an MCP client:
  10. ```json
  11. {
  12. "mcpServers": {
  13. "bead-colors": {
  14. "command": "npx",
  15. "args": ["-y", "@meltbead/bead-colors-mcp"]
  16. }
  17. }
  18. }
  19. ```
  20. Package: [@meltbead/bead-colors-mcp on npm](https://www.npmjs.com/package/@meltbead/bead-colors-mcp).
  21. ## Tools
  22. | Tool | Purpose |
  23. | --- | --- |
  24. | `list_palettes` | List palette IDs, materials, counts, data origins, licenses, status, and sources. |
  25. | `list_mard_kits` | List MARD retail-box sizes and their included codes; optionally filter by box size. |
  26. | `get_color` | Find a color by palette ID and code. |
  27. | `search_colors` | Search codes, names, HEX, brand, or series; results are limited. |
  28. | `nearest_colors` | Find the closest screen references in one palette by CIEDE2000 (ΔE00). |
  29. | `match_across_palettes` | Find one approximate match in each requested palette. |
  30. The service exposes 19 palettes: 11 existing 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. Search and cross-palette matching use representative palettes by default; subset palettes and the generated palette remain accessible by ID. Matching excludes effect finishes unless `includeEffects` is true. Discontinued Delica colors and unbuildable Minecraft map colors are excluded from automatic matches but remain available by code. Transparent entries without one RGB value cannot be matched.
  31. The eight bundled palettes are available as JSON in [`data/palettes/`](data/palettes/) and CSV in [`data/csv/`](data/csv/). MARD retail-box membership is also available as [`data/csv/mard-kits.csv`](data/csv/mard-kits.csv). CSV rows include Meltbead attribution, source URL, license, and status. Run `npm run build:csv` after editing JSON, then `npm run check:csv` to verify the exports.
  32. The matching score is CIEDE2000 (`deltaE`), calculated from each palette's sRGB screen reference. Smaller scores mean closer screen colors. They are not physical measurements or guarantees of material equivalence. `get_color` accepts case-insensitive codes and common separators; Delica codes also accept shorthand such as `DB10`, `DB-010`, and `10` for `DB0010`.
  33. Every color result includes a reminder to verify important shades against physical materials and printed product codes. Palette metadata includes the original data source and its status where supplied.
  34. ## Develop
  35. ```sh
  36. npm install
  37. npm start
  38. npm test
  39. npm run smoke
  40. ```
  41. `npm start` runs the local source server. `smoke` starts it through a real MCP stdio client, lists its tools, and calls them.
  42. ## License and data sources
  43. The server code is MIT licensed. The files in `data/` are published under [CC BY 4.0](LICENSE-DATA.md), with **[Meltbead](https://meltbead.com/)** as the attribution party. Suggested credit: `Color data: Meltbead (https://meltbead.com/)`. The additional palettes and MARD retail-box data are distributed under separate authorization from their rights holder. Underlying references and quality notes are in [`data/palettes/`](data/palettes/) and [`DATA_SOURCES.md`](DATA_SOURCES.md). The existing `@meltbead/bead-colors` dependency retains its [third-party notices](https://github.com/jsspace/bead-colors/blob/master/THIRD_PARTY_NOTICES.md). Brand names belong to their owners.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.