ต้นแบบ · รุ่นทดลอง: มีทุก server ในทะเบียนทางการ อัปเดตทุก 30 นาที เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิวได้แล้วต้นแบบ · อัปเดตทุก 30 นาที
PopNx MCPที่รวม MCP สำหรับคนใช้ AI · วิธีติดตั้งภาษาไทยทุกตัว เข้าสู่ระบบ

Luminous Music Player

โดย esoltysรุ่น 1.13.0i★ 0iรันบนเครื่องหน้า repo ↗
ชื่อใน registryio.github.esoltys/luminous-mcp

วิธีติดตั้ง

ใช้ทำอะไรได้

ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ

  • ต่อแบบ ติดตั้งในเครื่อง
  • บัญชีหรือคีย์ ไม่ต้องใส่คีย์
  • หมวด ออกแบบ ภาพ และเสียง
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Model Context Protocol (MCP) server for Luminous Music Player

ใช้คู่กับ

Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้

impeccable

impeccable เป็นชุดคำสั่งด้านการออกแบบสำหรับ coding agent ใช้กำกับงานให้ดูประณีตหรือโดดเด่นขึ้น ตรวจทานและวิจารณ์งานออกแบบ และช่วยจับงานที่ดูเป็น AI ชั้นต่ำก่อนนำไปใช้จริง

โดย pbakaus★ 113,5361 skill

Skill · คู่มือ

diagram-design

เครื่องมือสำหรับออกแบบไดอะแกรมแบบ editorial ใช้กับ Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder และ Pi มี 45 ประเภทไดอะแกรม สร้างผลลัพธ์เป็น HTML กับ SVG ที่ใช้งานได้ในไฟล์เดียว

โดย cathrynlavery★ 68,7131 skill

Skill · คู่มือ

frontend-slides

เครื่องมือเสริมชื่อ frontend-slides ใช้สร้างสไลด์สวยงามบนเว็บ โดยอาศัยทักษะด้าน frontend ของ coding agent

โดย zarazhangrui★ 32,6391 skill

Skill · คู่มือ

ทำไมอยู่อันดับนี้

หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้

ความนิยม0/80ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20
ความสด12/12ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม
ระบบยังตอบ0/8endpoint บนคลาวด์ตอบตอนตรวจล่าสุด
คะแนนการใช้งาน12/100

คุณภาพ: ผลตรวจเบื้องต้นผ่าน 2/3 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ผลตรวจผ่าน 2/3 · ทำงานบนเครื่องคุณ

ขั้นแรก: คุณใช้ AI ตัวไหน

เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง

ต่อกับ Claude ได้ แต่ต้องเตรียมก่อน

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ

  1. ดาวน์โหลดไฟล์ติดตั้งของผู้ทำ

    ดาวน์โหลดไฟล์ .mcpb ของผู้ทำ

    ไฟล์ .mcpb มาจากผู้ทำโดยตรง เราไม่ได้แก้ไฟล์

  2. ดับเบิลคลิกไฟล์ แล้วกด Install ในแอป Claude บนคอม

  3. ลองเลย

    ใช้ Luminous Music Player บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude บอกว่ากำลังใช้ Luminous Music Player หรือมีชื่อเครื่องมือของ Luminous Music Player ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ChatGPT ยังต่อ Luminous Music Player ไม่ได้

Luminous Music Player ต้องติดตั้งในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะตัวที่ทำงานบนเว็บ

คุณทำแบบนี้แทนได้

ก · ใช้แอปที่ต่อ Luminous Music Player ได้

  • ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ

ข · ตัวอื่นในหมวด ออกแบบ ภาพ และเสียง ที่ต่อกับ ChatGPT ได้

เลือกจากตัวที่ใช้มากในหมวดเดียวกัน เฉพาะตัวที่ต่อด้วยที่อยู่ได้โดยไม่ต้องใส่คีย์

Claude Code ยังต่อ Luminous Music Player ไม่ได้

ผู้ทำมีแต่ไฟล์ติดตั้งสำหรับแอป Claude บนคอม

คุณทำแบบนี้แทนได้

ก · ใช้แอปที่ต่อ Luminous Music Player ได้

  • ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ

Cursor ยังต่อ Luminous Music Player ไม่ได้

ผู้ทำมีแต่ไฟล์ติดตั้งสำหรับแอป Claude บนคอม

คุณทำแบบนี้แทนได้

ก · ใช้แอปที่ต่อ Luminous Music Player ได้

  • ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ

VS Code ยังต่อ Luminous Music Player ไม่ได้

ผู้ทำมีแต่ไฟล์ติดตั้งสำหรับแอป Claude บนคอม

คุณทำแบบนี้แทนได้

ก · ใช้แอปที่ต่อ Luminous Music Player ได้

  • ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ

โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม

ดูโปรแกรมที่ใช้ MCP ทั้งหมด →

ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง

ติดตรงไหน? ถามคนที่ใช้ Luminous Music Player อยู่💬 พูดคุย →

สรุป

ดาวน์โหลดต่อสัปดาห์i
ไม่มียอดใน npm/PyPI
licensei
ไม่ระบุ license
การเชื่อมต่อ
รันบนเครื่อง
รุ่นล่าสุดi
1.13.0
ส่งเข้า registryi
15 พ.ย. 2569
แก้โค้ดล่าสุดi
15 พ.ย. 2569
ผู้ทำ
esoltys
แพ็กเกจ
mcpb: …/luminous-mcp-windows-x64.mcpb
mcpb: …/luminous-mcp-darwin-arm64.mcpb
mcpb: …/luminous-mcp-darwin-x64.mcpb
เว็บผู้ทำ
github.com
สถานะใน registry
ใช้งานอยู่

ใช้กับโปรแกรมไหนได้

ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569

ติดตั้งบนเครื่องได้ใน

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

ดูโปรแกรมทั้งหมดพร้อมข้อดีข้อเสีย →

คู่มือที่เกี่ยวข้อง

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 20 พ.ย. 2569

  • ✓ ผ่าน

    ตัวตนผู้ทำตรงกับ repo

    ชื่อใน registry ยืนยันด้วยบัญชี GitHub esoltys ซึ่งเป็นเจ้าของ repo

  • ✓ ผ่าน

    ยังมีคนดูแล

    มีการแก้โค้ดล่าสุด 5 วันที่ผ่านมา

  • ✕ ไม่ผ่าน

    มีสัญญาอนุญาต (license)

    ไม่พบไฟล์ license ใน repo

  • – ไม่เกี่ยว

    endpoint ตอบ

    ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต

  • – ไม่เกี่ยว

    ล็อกอินแบบ OAuth

    ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน

  • … ยังไม่ตรวจ

    คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

    รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

ช่องโหว่ที่เปิดเผยแล้ว (OSV.dev)

ไม่ได้ตรวจ: ตรวจได้เฉพาะแพ็กเกจ npm และ PyPI ที่ระบุรุ่น

เราตรวจอะไรบ้าง → · JSON

ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README

ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้

[![แนะนำบน PopNx MCP](https://mcp.popnx.com/badge/esoltys-luminous-mcp.svg?lang=th)](https://mcp.popnx.com/th/servers/esoltys-luminous-mcp)

พูดคุย

ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์

ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย

ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx

เข้าสู่ระบบเพื่อโพสต์

รีวิวจากผู้ใช้

ยังไม่มีรีวิว

เข้าสู่ระบบเพื่อเขียนรีวิว

เทียบกับตัวอื่นในหมวด ออกแบบ ภาพ และเสียงi

  • ดาวมากกว่า 0% ของอีก 3358 ตัวในหมวดนี้
  • ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 85% ของอีก 3358 ตัวในหมวดนี้
  • ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 50% ของอีก 3358 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Luminous Music Player ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 2 จาก 3 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด 5 วันที่ผ่านมา และส่งรุ่นล่าสุด (1.13.0) เข้า registry 5 วันที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี MCPB ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server

ตัวอื่นที่ทำงานคล้ายกัน

หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

HyperFrames by HeyGen

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

โดย heygen-comใช้กันมาก★ 87.2K ดาวรวมทั้งรีโปอัปเดต เมื่อวานซืน

รันบนคลาวด์✓ heygen.com

Pascal 3D Editor

สร้าง ตรวจ และบันทึกฉากอาคาร 3 มิติที่แก้ไขได้ ด้วย Pascal

โดย pascalorgใช้กันมาก↓ 1K/สัปดาห์★ 25.7K ดาวรวมทั้งรีโปอัปเดต เมื่อวานซืน

บนเครื่องหรือคลาวด์✓ เจ้าของบริการ · pascal.app

draw.io

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

โดย jgraphใช้กันมาก★ 5.9Kอัปเดต 3 วันที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · draw.ioทีม PopNx ลองใช้จริงแล้ว

Figma MCP Server

server ทางการของ Figma ส่งข้อมูลงานออกแบบให้ AI อ่าน เพื่อเปลี่ยนแบบเป็นโค้ดหรืออธิบายแบบได้ตรงขึ้น ต่อผ่านคลาวด์ของ Figma

โดย figmaใช้กันมาก★ 2.2Kอัปเดต 13 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · mcp.figma.com

Remocn: Remotion MCP server

Hosted MCP for Remotion videos: search Remocn components, read docs, plan a video, preview it.

โดย Remocnกำลังโต★ 1.8Kอัปเดต 10 วันที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · remocn.dev
เทียบกับตัวที่คล้ายกัน
ตัวนี้
Luminous Music Player
HyperFrames by HeyGenPascal 3D Editordraw.ioFigma MCP ServerRemocn: Remotion MCP server
ทำงานที่ไหนต้องลงในเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องมีทั้งบนคลาวด์และแบบลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่อง
ต้องใส่คีย์ไม่ไม่ไม่ไม่ไม่ไม่
กด + ใน Claude ได้ไม่ใช่ไม่ไม่ใช่ไม่
ผลตรวจเบื้องต้น2/34/45/54/44/44/4
สัญญาอนุญาต–Apache-2.0MITApache-2.0–MIT
ราคาไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียน

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

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

ตัดมาแค่ช่วงต้น อ่านต่อใน repo