# Meltbead Craft Colors (MCP server)

> Meltbead Craft Colors is an MCP server that searches craft color palettes and match shades by CIEDE2000 with Meltbead. It has 108 GitHub stars, is released under the MIT license and runs locally with npx -y @meltbead/bead-colors-mcp. It works with Claude Desktop, Claude Code, Cursor and VS Code.

A local MCP server for craft color charts and approximate screen-color matching. It combines the existing @meltbead/bead-colors fuse bead references with eight locally bundled palettes distributed by Meltbead under direct authorization. No account or network request is needed after installation.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/jsspace/bead-colors-mcp |
| GitHub stars | 108 |
| License | MIT |
| Language | JavaScript |
| Transport | stdio |
| Packages | npm: @meltbead/bead-colors-mcp |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Other |
| Latest release | none |
| Last commit | Nov 4, 2026 |
| MCP registry name | io.github.jsspace/bead-colors-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

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

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

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

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

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

Project file; use ~/.cursor/mcp.json to enable it in every project.

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

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

Config formats checked against the official docs on 2026-10-07.

## Tools

- `list_palettes`: List palette IDs, materials, counts, data origins, licenses, status, and sources.
- `list_mard_kits`: List MARD retail-box sizes and their included codes; optionally filter by box size.
- `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 (ΔE00).
- `match_across_palettes`: Find one approximate match in each requested palette.

## Similar MCP servers

- [UI5 MCP Server](https://appsgit.com/mcp-servers/ui5-mcp-server): MCP server for SAPUI5/OpenUI5 development. (109 stars, Apache-2.0, official)
- [Orcaslicer MCP](https://appsgit.com/mcp-servers/orcaslicer-mcp): Work a running OrcaSlicer with AI: slice, tune, and understand what each setting costs. (107 stars, AGPL-3.0, needs API key)
- [MCP Bridge](https://appsgit.com/mcp-servers/mcp-bridge): Exposes silverbullet-ai tools from a SilverBullet space to MCP clients. (109 stars, AGPL-3.0, needs API key)
- [MCP Abap Adt](https://appsgit.com/mcp-servers/mcp-abap-adt): MCP server for SAP ABAP ADT over HTTP, RFC or SNC: repository analysis and RAP/classic ABAP CRUD. (106 stars, Apache-2.0, needs API key)
- [Hyperiux Vault](https://appsgit.com/mcp-servers/hyperiux-vault): Browse, inspect, and retrieve installable React and Next.js interaction effects from Hyperiux Vault. (113 stars, MIT)
- [runx](https://appsgit.com/mcp-servers/runx): The governed runtime for agent skills. Search the catalog and inspect a skill before running it. (103 stars, Apache-2.0, official)

---

Canonical page: https://appsgit.com/mcp-servers/meltbead-craft-colors
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.
