SkillFoxx

aurlune Yandex Music player MCP server

aurlune

An MCP server for a local Rust-based Yandex Music player and sync daemon on Linux: playback control, taste profile, mood picks

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • Uses a Yandex Music token to like tracks and download them on your account
  • Runs an mpv-based player daemon and controls playback
All reasons and checks
Russian stack

blysspeak/aurluneAuthor:Blysspeak

Install

Services

Manual install

cargo build --release
install -Dm755 target/release/{aurluned,lune,aurlune-mcp} ~/.local/bin/
lune daemon install && lune daemon start

Builds from source and installs the daemon; requires Rust.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Uses a Yandex Music token to like tracks and download them on your account
  • Runs an mpv-based player daemon and controls playback

This is third-party code. Review the repository files before installing.

What it does

aurlune is a set of a Yandex Music client library, the aurluned daemon that plays music via mpv over IPC with MPRIS integration and KDE notifications, the lune CLI, and the aurlune-mcp MCP server for Claude. The MCP tools proxy player commands: state, play, pause, next, prev, queue, local and remote search, track download, like, facet- and taste-profile-based picks, history and feedback. Before any control, the player_state tool checks who started playback and forbids the agent from starting or stopping music on its own if someone else started it and the user did not explicitly ask this session. The player has no concept of mood itself: the agent picks a track via facets and taste_profile, explains the choice, and later asks for feedback through the feedback tool. Downloaded tracks are not auto-liked in Yandex Music; a like only happens on the user's explicit word.

Who it is for. For Linux users on KDE Plasma who listen to Yandex Music locally and want to control playback and picks through Claude.

Good fit when

  • You want a local Yandex Music player on Linux with sync and no cloud middleman
  • You want the agent to pick music by a taste profile rather than guessing a mood
  • You care that the agent does not hijack music you already started yourself

Not a fit when

  • You are not on Arch Linux with KDE Plasma and Wayland: the README is verified on exactly that combination
  • You need a ready binary release rather than a source build with Rust

Example request

Play something calm for coding

MCP

Transport
stdio
Authentication
API key

Environment variables

AURLUNE_SESSION
A session name identifying which client issued a player command

Limitations

The verified environment is Arch Linux, KDE Plasma, Wayland, mpv 0.40 or newer, and Rust 1.98 to build. You need a Yandex Music token in ~/.config/ym/token with 0600 permissions. The project builds from source with cargo build; there are no ready packages. A large part of the repository is speckit framework specs and templates, not just the player code.

How to disable. Stop the daemon with lune daemon stop, remove its autostart, and delete the aurlune entry from your MCP client configuration.

FAQ

Can Claude stop music I started myself?

No, the player_state tool checks who started playback and stops the agent from hijacking it without an explicit request this session.

Are downloaded tracks auto-liked in Yandex Music?

No, a like only happens when the user explicitly asks for it through the like tool.

Discussion

No questions or reviews yet.

All Yandex Music tools
Russian stack

A browser-free Yandex Music MCP server: the agent queues a playlist, a local daemon plays it via mpv with Now Playing in Control Center

MCP serverExtended access1
Russian stack

A single-file, zero-install Yandex Music MCP server via uv: likes, playlists, search and taste analysis

MCP serverExtended access
Russian stack

An unofficial Yandex Music MCP server: likes, genre analysis, search and playlist management over HTTP or stdio

MCP serverExtended access2

Yandex Music playlist creation MCP server

Yandex Music MCP Server (unofficial)

Russian stack

A minimal MCP server for creating Yandex Music playlists: search tracks and add them to a playlist

MCP serverExtended access1
Russian stack

A Redis-backed queue MCP server that downloads tracks from SoundCloud, YouTube, Yandex Music and Spotify, transcodes them and tags them with cover art

MCP serverExtended access5

A Rust music server with MCP: an agent searches tracks, builds a queue and picks the next ones by tempo and energy.

MCP serverExtended access533

README in short

The main README is short and lists the project's four parts: the client library, the daemon, the CLI and the MCP server. Details live in the specs: contracts/mcp-tools.md describes all 16 tools and the autostart rules, and quickstart.md gives a step-by-step check from build to the first Claude request, with expected behavior and a listening-history privacy check.

README badge

Report a problem