v1.12.1

What's Changed

• feat(release): publish to the official MCP Registry by @esoltys in #98
• chore(release): bump version to 1.12.1 by @esoltys in #99

Full Changelog: v1.12.0...v1.12.1

v1.12.0

What's Changed

• feat: support folded album keys (album_key) in track metadata and album profiles by @esoltys in #90
• feat: sync with Luminous schema v82 by @esoltys in #93
• chore(deps): consolidate dependabot bumps by @esoltys in #95
• ci: sign MCPB bundles with PEM certificate/key secrets by @esoltys in #96
• chore(release): bump version to 1.12.0 by @esoltys in #97

Full Changelog: v1.0.1...v1.12.0

v1.0.1

What's Changed

• ci: sign release checksums with cosign (keyless) by @esoltys in #84
• chore: release 1.0.1 by @esoltys in #85

Full Changelog: v1.0.0...v1.0.1

v1.0.0

Luminous MCP 1.0.0

First stable release of the MCP server for Luminous Music Player. Ask your AI assistant about your local library, listening history and playlists, curate metadata, and control playback.

Highlights

• Library and analytics: full-text search with structured filters, track details, artist summaries, listening stats and play history.
• Curation: artist and album profiles, tag lookups, metadata auditing, playlists, and MusicBrainz lookups.
• Playback control: transport, queueing and "pause after track" through the running Luminous app.
• New in this release: get_artist_events (cached upcoming concerts), a loved flag on tracks, lookup_musicbrainz respects Luminous's Offline mode, and support for Luminous schema v61.
• Remote agents: optional SSE/HTTP transport (bun run start:sse).
• Token-efficient responses: compact JSON with empty fields stripped.

Install

Download the .mcpb for your platform below and open it with Claude Desktop (or drag it in):

Platform	File
Windows (x64)	luminous-mcp-windows-x64.mcpb
macOS (Apple silicon)	luminous-mcp-darwin-arm64.mcpb
macOS (Intel)	luminous-mcp-darwin-x64.mcpb
Linux (x64)	luminous-mcp-linux-x64.mcpb
Linux (arm64)	luminous-mcp-linux-arm64.mcpb

Verify downloads against SHA256SUMS.txt. The bundles are not code-signed, so your OS may show a warning on first run.

Portable Luminous installs keep their database in <luminous folder>/data/; set the Luminous database option in the extension settings (or LUMINOUS_DATA_DIR). See PRIVACY.md for what leaves your machine (nothing, apart from the optional MusicBrainz lookup).

What's Changed

• docs: fix markdown formatting and code fence encoding by @esoltys in #11
• feat: MCP server foundation, SQLite path resolution, and system tools (#3) by @esoltys in #12
• feat: support MCPB bundle packaging for one-click desktop installation (#13) by @esoltys in #14
• fix: resolve local mcpb binary and scoped @anthropic-ai/mcpb in packaging script (#15) by @esoltys in #16
• ci: add build and bundle packaging verification to CI workflow (#17) by @esoltys in #18
• feat: implement library search, track details, and artist summary tools (#5) by @esoltys in #19
• feat: implement listening analytics, insights, and playback history tools (#6) by @esoltys in #20
• feat: implement playlist management tools (#7) by @esoltys in #29
• feat: implement metadata hygiene, curation, artist profiles, and musicbrainz tools (#8) by @esoltys in #30
• docs: document packaging background task behavior and exit cleanly by @esoltys in #31
• perf: use compact JSON serialization for MCP text responses (#28) by @esoltys in #32
• perf: strip null, undefined, and empty metadata fields across tool responses (#23) by @esoltys in #33
• perf: gate full lyrics in get_track_details behind include_lyrics flag (#22) by @esoltys in #34
• perf: streamline search_library with compact default fields and detail_level option (#24) by @esoltys in #35
• perf: deduplicate redundant timestamp, ratio, and duration metrics (#25) by @esoltys in #36
• perf: cap unbounded collections in get_artist_summary (#26) by @esoltys in #37
• feat: add offset pagination and metadata to search_library and get_recent_history (#27) by @esoltys in #38
• docs: add Token Efficiency & Optimization feature and impact summary to README (#21) by @esoltys in #39
• docs: remove emojis from README section headings by @esoltys in #40
• docs: add Example Prompts section to README by @esoltys in #41
• feat: implement desktop playback control bridge and real-time UI sync (#9) by @esoltys in #42
• feat: implement pause_after_track playback tool and bundle into mcpb (#43) by @esoltys in #44
• feat: add stop_at options and enrich description for pause_after_track (#45) by @esoltys in #46
• feat: add album description, external links, and bio source extraction tools (#47) by @esoltys in #48
• fix: support balanced parentheses in bio link parser (#49) by @esoltys in #50
• feat(curation): emit library-changed bridge event on artist, album, and track mutations by @esoltys in #52
• docs: add CLAUDE.md with architecture and command reference by @esoltys in #53
• feat: add update-artist-bio skill by @esoltys in #55
• feat(curation): add find_artists_by_tag tool by @esoltys in #56
• fix(curation): migrate missing tags/links columns on profile tables by @esoltys in #58
• fix(curation): steer update_album_profile toward links array over inline markdown by @esoltys in #59
• feat: add SSE HTTP transport server for remote agents (#60) by @esoltys in #61
• docs: refine playback/history tool descriptions and add OpenClaw skill by @esoltys in #62
• feat: include skills directory in mcpb bundle packaging by @esoltys in #63
• Sync with Luminous schema v61: loved flag, offline mode, portable docs by @esoltys in #69
• Add get_artist_events tool for cached upcoming concerts by @esoltys in #71
• build(deps): consolidate dependabot bumps (zod 4, typescript 7, checkout 7) by @esoltys in #72
• Release groundwork: per-platform bundles, release workflow, manifest polish by @esoltys in #79
• ci: cross-platform tests, cross-compile check, release dry run by @esoltys in #82
• build(deps): bump @modelcontextprotocol/sdk from 1.30.0 to 1.32.1 by @dependabot[bot] in #80
• chore: release 1.0.0 by @esoltys in #81

New Contributors

• @esoltys made their first contribution in #11
• @dependabot[bot] made their first contribution in #80

Full Changelog: https://github.com/esoltys/luminous-mcp/commits/v1.0.0