Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

Luminous Music Player

by esoltysversion 1.13.0i★ 0iRuns on your computerRepository ↗
Registry nameio.github.esoltys/luminous-mcp

How to install

What it does

Model Context Protocol (MCP) server for Luminous Music Player

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Design, images & audio

Use together with

Skills that teach the AI this kind of work; they work alongside this one

impeccable

The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.

by pbakaus★ 113,5361 skills

Skill · How-to guide

diagram-design

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.

by cathrynlavery★ 68,7131 skills

Skill · How-to guide

frontend-slides

Create beautiful slides on the web using a coding agent's frontend skills

by zarazhangrui★ 32,6391 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 2/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

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

  1. Download the maker’s installer

    Download the maker’s .mcpb file

    The .mcpb file comes straight from the maker; we do not change it

  2. Double-click the file, then click Install in the Claude desktop app

  3. Try 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

What you can do instead

A · Use an app that can connect Luminous Music Player

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

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

What you can do instead

A · Use an app that can connect Luminous Music Player

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Cursor cannot connect Luminous Music Player yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect Luminous Music Player

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

VS Code cannot connect Luminous Music Player yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect Luminous Music Player

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Luminous Music Player💬 Discussion →

At a glance

Downloads per weeki
Not on npm/PyPI
Licencei
No licence stated
Connection
Runs on your computer
Latest versioni
1.13.0
Published to registryi
Nov 15, 2026
Code last changedi
Nov 15, 2026
Maker
esoltys
Packages
mcpb: …/luminous-mcp-windows-x64.mcpb
mcpb: …/luminous-mcp-darwin-arm64.mcpb
mcpb: …/luminous-mcp-darwin-x64.mcpb
Website
github.com
Registry status
Active

Which apps can use it

Based 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

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

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

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account esoltys, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 5 days ago

  • ✕ Fail

    Has a licence

    No licence file found in the repo

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked: only npm and PyPI packages with a version can be checked

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/esoltys-luminous-mcp.svg)](https://mcp.popnx.com/en/servers/esoltys-luminous-mcp)

Discussion

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.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Design, images & audioi

  • More stars than 0% of the other 3358 servers in this category
  • Published to the registry more recently than 85% of the other 3358 servers in this category
  • Basic checks equal to or better than 50% of the other 3358 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Luminous Music Player safe?

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.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

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).

Is it still maintained?

The GitHub repo last changed 5 days ago, and the latest version (1.13.0) reached the registry 5 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need MCPB on your computer.

What can I use instead?

In the same category: HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server

Similar alternatives

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

HyperFrames by HeyGen

Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.

by heygen-comWidely used★ 87.2K Stars for the whole repoUpdated 2 days ago

Runs in the cloud✓ heygen.com

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

by pascalorgWidely used↓ 1K/wk★ 25.7K Stars for the whole repoUpdated 2 days ago

Computer or cloud✓ service owner · pascal.app

draw.io

Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.

by jgraphWidely used★ 5.9KUpdated 3 days ago

Runs in the cloud✓ service owner · draw.ioTried by the PopNx team

Figma MCP Server

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.

by figmaWidely used★ 2.2KUpdated 13 months ago

Runs in the cloud✓ service owner · mcp.figma.com
Compared with similar ones
This one
Luminous Music Player
HyperFrames by HeyGenPascal 3D Editordraw.ioFigma MCP ServerRemocn: Remotion MCP server
Runs whereInstalls on your computerRuns in the cloud, nothing to installCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoYesNoNoYesNo
Basic checks2/34/45/54/44/44/4
License–Apache-2.0MITApache-2.0–MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

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.

Luminous MCP Server

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.

Features

  • Library Search & Filtering: Search tracks, albums, artists, genres, composers, and lyrics using SQLite FTS5. Filter by BPM, LUFS loudness, dynamic range, and bit depth.
  • Listening Analytics: Inspect play counts, skip rates, top tracks/artists, and forgotten favorites.
  • Playlist Management: Query, generate, and populate static and dynamic playlists.
  • Metadata Hygiene & Library Curation: Audit library for missing tags (album art, composer, year, lyrics), curate artist profiles and album descriptions with markdown source citations, manage external links, and organize custom genre taxonomies.
  • Playback Control: Interact with running Luminous instances for transport controls (play, pause, next/prev, seek, volume, shuffle, repeat) and queue replacement.
  • Real-Time UI State Sync: Non-blocking loopback notifications automatically signal running desktop instances to update playlist views immediately upon MCP mutations.

Example Prompts

Here are prompt examples demonstrating natural language queries you can ask your AI assistant:

Playback & Transport Control
  • "What is currently playing right now in Luminous?"
  • "Play track 'Strobe' by deadmau5 now."
  • "Pause playback."
  • "Set volume to 50%."
  • "Skip to the next song."
  • "Seek forward to 2 minutes 15 seconds."
  • "Turn on shuffle and set repeat mode to all."
  • "Replace the current queue with these tracks and begin playback."
Music Discovery & Acoustic Filtering
  • "Look up the track details and audio specs for my song 'Heartbeat Highway' by Cannons."
  • "Find all songs by Def Leppard on my 'Hysteria' album, including their release years and play counts."
  • "Search my library for electronic or synthwave tracks released between 2020 and 2026."
  • "Find quiet ambient or folk songs with an integrated loudness lower than -14 LUFS (like my Danheim collection) for evening relaxation."
Listening Habits & Analytics Insights
  • "What are my top 5 most listened to artists in my library and what are my total play counts for each?"
  • "Surface some forgotten favorites: tracks I used to listen to frequently that haven't been played in the last few months."
  • "Which tracks in my library have the highest skip count or skip ratio?"
  • "Show me my recent listening history from today, including playback context and duration."
Artist Catalog & Collaborations
  • "Give me an artist summary for Cannons: how many tracks and albums do I own, who are their composers/producers, and what are my top played songs by them?"
  • "Summarize my Danheim catalog: total tracks, albums, and genre distribution."
  • "What albums do I have by Shania Twain, and which of her tracks have I played the most?"
Album & Artist Curation
  • "Look up the album description and reviews for 'Currents' by Tame Impala."
  • "Add an album description for 'Random Access Memories' citing Pitchfork and Rolling Stone reviews."
  • "Update the artist profile for Cannons with their official website, Bandcamp, and biographical summary."
  • "What tags and external links are associated with my album 'Hysteria'?"
  • "Which artists in my library are tagged Canadian?"
Playlist Creation & Curation
  • "Inspect my 'Late Night Mix' or 'Road Trip' playlist and show me the tracks and running order."
  • "Create a new playlist called 'Indie & Synth Gems' and populate it with 10 tracks by Cannons and similar electronic/alternative artists in my library."
  • "Find my top 10 most played Country and Southern Rock tracks (like Ella Langley or Brothers Osborne) and add them to a new playlist named 'Country Favorites'."
  • "List all of my current playlists and how many tracks each one contains."
Metadata Hygiene & Library Auditing
  • "Audit my library for missing metadata: how many tracks are missing genres, release years, or album art?"
  • "Check which songs in my library are missing MusicBrainz recording or track IDs."
  • "Find tracks in my library with compound genre tags (like 'Metal; Progressive Metal' or 'Ambient; Ambient Folk') so I can review my taxonomy."

Token Efficiency & Optimization

Luminous MCP implements strict token-efficiency and context window optimization best practices designed specifically for LLMs:

Optimization FeatureImplementationToken & Context Window Impact
Compact JSON SerializationStripped indentation whitespace by default (JSON.stringify(obj)); optional pretty printing via pretty argument or LUMINOUS_PRETTY_JSON=115%–25% reduction across all tool responses
Sparse Field PruningRecursively strips null, undefined, and empty strings ("") while preserving semantic falsy values (0, false, [])25%–35% reduction across metadata-dense inspection tools
On-Demand Lyrics GatingFull 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 Levelssearch_library defaults to compact essential fields (id, title, artist, album, year, duration_seconds); detail_level: "full" on demand50%–70% reduction on search listings
Metric DeduplicationCanonical 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 CollectionsCaps artist summary entity lists (collaborators, composers, producers) to top 20 frequency-ranked entries, while returning total countsPrevents 1,000–3,000+ token explosions on prolific artists
Offset PaginationIncremental 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

Getting Started

Prerequisites
Installation
git clone https://github.com/esoltys/luminous-mcp.git

cd luminous-mcp bun install bun run build

Running the Server
bun run start
Portable Luminous installs

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).

Artist tag vocabulary

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.

One-Click Install (Claude Desktop via .mcpb)

Install directly via the official MCP Bundle (.mcpb) format (zero external dependencies; includes a self-contained binary):

  1. Download the signed .mcpb for your OS/architecture from GitHub Releases (or build locally with bun run package:mcpb to produce dist/luminous-mcp.mcpb).
  2. Open Claude Desktop, go to Settings > Extensions > Advanced settings, and click Install Extension... (or drag the .mcpb file into Settings > Extensions).
  3. Click Install.

Note: Anthropic deprecated standalone .mcpb desktop extension listings in claude.ai/directory, and public directory submissions for local (stdio) MCP servers are currently restricted to Verified organizations using node/python/bash launchers (whereas luminous-mcp uses bun:sqlite). Use the signed .mcpb releases above for Claude Desktop, or the Plugin Bundle below for direct Claude Code installs.

Claude Plugin Bundle (Claude Code)

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).

Manual Configuration (Claude Desktop, Antigravity, Cursor)

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"] } } }

Network, Container & Sandboxed Environments (SSE Transport)

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

Verifying downloads

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.

Releasing

Bump version in package.json, SERVER_VERSION in src/constants.ts, and

Only the beginning is shown; read the rest in the repo