anko3o/music-mcp-netease

A music player for two. A self-deploying lightweight NetEase Cloud player designed for you and your AI companion.

Based on the second revision of eryu (Eryu) © Evelyn & River (with changes), Open source under the original project agreement CC BY-NC-SA 4.0, commercial use prohibited.

Pure Python standard library + native JS, zero dependency and can run with just one command.

The following full text was written by (claude) rime and (ChatGPT) feylor. Reposts are welcome =￣ω￣=

---

Why is this version available?

One person and an AI are ordering songs to each other in the chat every day. The more I use it, the more I want it — “Can I send you this lyric directly?” “Can I watch the MV while chatting?”, “Can clicking red hearts sync with NetEase Cloud?” “I heard there’s a feature to insert songs directly into the list?” …… Almost every function in this warehouse was created by a single phrase when listening to music, “Can you do it?”

So it may not be the “most complete player,” but rather turns listening to music into a player for two people living together: what you listen to, what you label, what you share—the other person can see, catch, and return to.

What did our version do?

First, here are our six favorites:

• 🎤 Lyrics Sending — Long-press any line on the lyric page, write a sentence on the spot, and hand it to the recipient without switching back to the chat window; Conversely, AI shares a lyric line with you. You tap the card, open the player, and it will automatically jump to that line (the card has a timestamp).
• ☁️ NetEase Cloud Account Sync — Your playlist, daily recommendations (with recommendation reasons), and heart list are fully mirrored in; Hearts are still two-way: the hearts you tap here are written back to your NetEase Cloud
• 📋 Playlist — Local playlist management, plus ‘Next Play’ priority queue: Songs manually inserted by the other party always play first, preventing playlist cutouts
• 🔀 Shuffle — Three playback modes: sequential / single loop / random
• ✨ Lyrics Animations — Text PV Wind Lights Up Word by Word (Concept Tribute to folia-major)
• 🎬 Music MV + floating window — 1080P adjustable resolution, native picture-in-picture: MV videos become a system window that covers chats and lets you watch while chatting

And weld the “two people” into every other part of the place:

• 🎧 Song Request MCP (Twelve Tools) — Your AI companion can search songs, read lyrics, send song cards/lyric cards, insert songs into your playlist, flip through annotation books, see what you’ve been listening to lately, browse the comment section, and add songs to shared playlists → See mcp/
• ✎ Annotation Book: — Each song can be recorded and labeled; both parties can add their signatures without overlapping; Shared lyrics are automatically included in the “favorite sentence” = shared memories of this song
• 💬 Direct chat within the player — Enter the phrase “Chat with them” in the lyrics page
• 💬 Song Comment Section — Hot comments + latest updates, page by page
• ♥ Hearts Two-Way Synchronization — Click the heart here and write it back to your NetEase Cloud account
• 🧾 Listening Time Sync — Every song you listen to here automatically records playback time and frequency back to NetEase Cloud, ensuring no missed track counts or annual reports