impeccable
The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.
Model Context Protocol (MCP) server for Luminous Music Player
Skills that teach the AI this kind of work; they work alongside this one
The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.
Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.
Create beautiful slides on the web using a coding agent's frontend skills
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 0/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 12/100 |
Quality: Passed 2/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Passed 2/3 checks · Runs on your computer
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone
Download the maker’s .mcpb file
The .mcpb file comes straight from the maker; we do not change it
Use Luminous Music Player and tell me what you can do for me, then show me one thing✓ If Claude says it is using Luminous Music Player or shows a Luminous Music Player tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Luminous Music Player yet
Luminous Music Player runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Luminous Music Player
B · Others in Design, images & audio that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Claude Code cannot connect Luminous Music Player yet
The maker only provides an installer for the Claude desktop app
A · Use an app that can connect Luminous Music Player
Cursor cannot connect Luminous Music Player yet
The maker only provides an installer for the Claude desktop app
A · Use an app that can connect Luminous Music Player
VS Code cannot connect Luminous Music Player yet
The maker only provides an installer for the Claude desktop app
A · Use an app that can connect Luminous Music Player
mcpb: …/luminous-mcp-windows-x64.mcpbmcpb: …/luminous-mcp-darwin-arm64.mcpbmcpb: …/luminous-mcp-darwin-x64.mcpbBased on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026
The registry name was verified with the GitHub account esoltys, which owns the repo
Code last changed 5 days ago
No licence file found in the repo
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Not checked: only npm and PyPI packages with a version can be checked
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/esoltys-luminous-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 5 days ago, and the latest version (1.13.0) reached the registry 5 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need MCPB on your computer.
In the same category: HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.
Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.
Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.
Figma’s official server gives AI your design data so it can turn designs into code or describe them accurately. Connects to Figma’s cloud.
Hosted MCP for Remotion videos: search Remocn components, read docs, plan a video, preview it.
| This one Luminous Music Player | HyperFrames by HeyGen | Pascal 3D Editor | draw.io | Figma MCP Server | Remocn: Remotion MCP server | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Cloud or install on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | No | No | No | No | No | No |
| Add with + in Claude | No | Yes | No | No | Yes | No |
| Basic checks | 2/3 | 4/4 | 5/5 | 4/4 | 4/4 | 4/4 |
| License | – | Apache-2.0 | MIT | Apache-2.0 | – | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
A Model Context Protocol (MCP) server for Luminous Music Player.
Connects your AI assistants (Claude Desktop, Antigravity, Cursor, Zed, Ollama) to your local music library.
Here are prompt examples demonstrating natural language queries you can ask your AI assistant:
Luminous MCP implements strict token-efficiency and context window optimization best practices designed specifically for LLMs:
| Optimization Feature | Implementation | Token & Context Window Impact |
|---|---|---|
| Compact JSON Serialization | Stripped indentation whitespace by default (JSON.stringify(obj)); optional pretty printing via pretty argument or LUMINOUS_PRETTY_JSON=1 | 15%–25% reduction across all tool responses |
| Sparse Field Pruning | Recursively strips null, undefined, and empty strings ("") while preserving semantic falsy values (0, false, []) | 25%–35% reduction across metadata-dense inspection tools |
| On-Demand Lyrics Gating | Full song lyrics gated behind explicit include_lyrics: true flag in get_track_details (defaults to boolean indicator has_lyrics) | 500–1,500+ tokens saved per track lookup |
| Search Detail Levels | search_library defaults to compact essential fields (id, title, artist, album, year, duration_seconds); detail_level: "full" on demand | 50%–70% reduction on search listings |
| Metric Deduplication | Canonical ISO 8601 timestamps (last_played_iso, played_at_iso), single float ratios (skip_ratio), and seconds durations (duration_seconds) | 15%–20% reduction on analytics and history queries |
| Bounded Collections | Caps artist summary entity lists (collaborators, composers, producers) to top 20 frequency-ranked entries, while returning total counts | Prevents 1,000–3,000+ token explosions on prolific artists |
| Offset Pagination | Incremental limit & offset pagination with total_matches and has_more metadata for search_library, get_recent_history, find_artists_by_tag and list_artists (full-library artist enumeration with has_profile curation flag and country filter) | Eliminates redundant page re-fetching during multi-turn exploration |
git clone https://github.com/esoltys/luminous-mcp.git
cd luminous-mcp bun install bun run build
bun run start
In portable mode (a portable or luminous.portable file, or a data/ folder, next to the Luminous executable) the library lives in /data/luminous.db, which the server cannot discover automatically. Point it there with LUMINOUS_DATA_DIR= /data (or LUMINOUS_DB_PATH).
update_artist_profile / update_artist_profiles only accept curated attribute tags: by default nationality (Canadian) and named awards (Grammy Award) are allowed, genre and decade/era tags are rejected, and other tags are accepted with a warning. get_tag_policy returns the rules in force and list_artist_tags reports every tag in use (case variants grouped, each marked allowed / unknown / denied) without changing anything.
To use your own rules, point LUMINOUS_ARTIST_TAG_VOCAB at a JSON file. It replaces the defaults entirely and a missing or invalid file stops the server at startup:
{
"unknown_tags": "reject", "categories": [ { "id": "label", "label": "record label", "kind": "allowed", "description": "Label", "values": ["Sub Pop"], "examples": ["Sub Pop"] }, { "id": "mood", "label": "mood", "kind": "denied", "description": "Moods are subjective", "values": ["Sad"] } ] }
values match tags exactly and patterns are regular expressions matched against the whole tag, both case-insensitively. Denied categories win over allowed ones. Decade/era tags are still rejected on album profiles when the vocabulary has a category with id decade_era.
.mcpb)Install directly via the official MCP Bundle (.mcpb) format (zero external dependencies; includes a self-contained binary):
.mcpb for your OS/architecture from GitHub Releases (or build locally with bun run package:mcpb to produce dist/luminous-mcp.mcpb)..mcpb file into Settings > Extensions).Note: Anthropic deprecated standalone
.mcpbdesktop extension listings inclaude.ai/directory, and public directory submissions for local (stdio) MCP servers are currently restricted to Verified organizations usingnode/python/bashlaunchers (whereasluminous-mcpusesbun:sqlite). Use the signed.mcpbreleases above for Claude Desktop, or the Plugin Bundle below for direct Claude Code installs.
This repository includes .claude-plugin/plugin.json, .mcp.json, and skills/luminous/SKILL.md for direct installation as a local Claude Code plugin from GitHub (requires Bun v1.1+ on PATH).
Alternatively, add luminous to your claude_desktop_config.json or MCP client configuration:
{
"mcpServers": { "luminous": { "command": "bun", "args": ["run", "C:/path/to/luminous-mcp/src/index.ts"] } } }
When running AI assistants or agents inside a container, WSL sandbox, or remote host, run Luminous MCP natively on the host with the SSE HTTP transport:
bun run start:sse
By default, this listens on http://0.0.0.0:21850/sse (override with LUMINOUS_MCP_PORT and LUMINOUS_MCP_HOST). It also exposes a GET /health endpoint for health checks.
Connect your client using the SSE URL:
{
"mcpServers": { "luminous": { "url": "http:// :21850/sse" } } }
For OpenClaw running in WSL or Docker:
openclaw mcp add luminous --url http://<host-ip>:21850/sse --transport sse
Each .mcpb bundle is signed with an embedded PEM signature (mcpb sign), and each release publishes SHA256SUMS.txt plus SHA256SUMS.txt.sigstore.json, a cosign keyless signature made by this repository's Release workflow (no certificate is bought or stored; the signing identity is recorded in the public Sigstore log). To verify a download:
bun x @anthropic-ai/mcpb verify luminous-mcp-linux-x64.mcpb
bun x @anthropic-ai/mcpb info luminous-mcp-linux-x64.mcpb
And to verify the release checksums with Cosign:
cosign verify-blob SHA256SUMS.txt \
--bundle SHA256SUMS.txt.sigstore.json \ --certificate-identity-regexp '^https://github.com/esoltys/luminous-mcp/\.github/workflows/release\.yml@refs/tags/v.*$' \ --certificate-oidc-issuer https://token.actions.githubusercontent.com sha256sum --check --ignore-missing SHA256SUMS.txt # macOS: shasum -a 256 -c
The .mcpb signature verifies the bundle archive itself; the standalone binaries inside are not OS code-signed, so Windows SmartScreen or macOS Gatekeeper may warn on first run.
Bump version in package.json, SERVER_VERSION in src/constants.ts, and