mcp-mpv-player
Control the mpv media player through AI conversation to play media files, manage playback, and organize playlists. It auto-launches mpv if not running and integrates with MCP-compatible AI tools. Designed for Windows 10/11 via mpv's JSON IPC over Windows Named Pipe.
Playback Control
Play (
player_play): Open any file or URL (http/https/rtmp, etc.), with option to append to current playlistPause/Resume (
player_pause): Toggle pause and resumeStop (
player_stop): Stop playback and clear the current fileNext/Previous (
player_next,player_prev): Navigate between tracksSeek (
player_seek): Jump using relative (seconds), absolute (timestamp), or percentage-based seekingVolume (
player_set_volume): Adjust from 0 to 130Speed (
player_set_speed): Change playback speed (e.g. 0.5x, 1.0x, 2.0x)Status (
player_status): Retrieve file name, position, duration, volume, speed, and pause stateShuffle (
player_shuffle): Randomly shuffle the current playlist
Playlist Management (saved as .m3u files)
Create (
playlist_create): Create a new named playlist from a list of file paths or URLsLoad (
playlist_load): Load and play a saved playlist by nameAdd (
playlist_add): Append files to an existing playlistRemove (
playlist_remove): Remove a track by its 0-based indexList (
playlist_list): View all saved playlists or inspect the contents of a specific oneDelete (
playlist_delete): Permanently delete a saved playlist file
Allows control of the mpv media player via AI conversation, providing tools for playback management (play, pause, stop, seek, volume, and speed control) and comprehensive playlist management (creating, loading, and modifying playlists).
mcp-mpv-player
Control mpv media player through AI conversation. Play music and video, manage playlists — all via natural language.
Works with opencode and any MCP-compatible AI tool.
Installation
Make sure Node.js is installed, then run:
npx mcp-mpv-playerThe setup wizard will automatically:
Detect or install mpv
Locate your opencode config file
Register the MCP tool
Restart opencode when done.
Usage Examples
Just talk to your AI naturally:
Play D:/Music/song.mp3
Pause
Next track
Skip forward 30 seconds
Jump to 2 minutes 30 seconds
Set volume to 80
Create a playlist called "chill" with D:/Music/a.mp3 and D:/Music/b.mp3
Play the "chill" playlist
ShuffleTools
Playback Control
Tool | Description |
| Play a file or URL, auto-starts mpv |
| Toggle pause / resume |
| Stop playback |
| Next track |
| Previous track |
| Seek by seconds / absolute time / percent |
| Set volume (0–130) |
| Set playback speed (0.5x / 1x / 2x …) |
| Get current playback status |
| Shuffle playlist and play from the start |
Playlist Management
Tool | Description |
| Create a new playlist |
| Load and play a saved playlist |
| Add files to a playlist |
| Remove a track from a playlist |
| List all playlists or inspect one |
| Delete a playlist |
Playlists are saved as .m3u files in %USERPROFILE%\mpv-playlists\.
Requirements
Windows 10 / 11
Node.js 18+
mpv (can be installed automatically by the setup wizard)
How It Works
mpv exposes a JSON IPC interface via a Windows Named Pipe (\\.\pipe\mpv-ipc). This tool runs as an MCP server, receives commands from the AI, and forwards them to mpv.
When player_play is called and mpv is not running, it is launched automatically with the IPC flag and stays running in the background between tracks.
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Appeared in Searches
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/guodaxia9527/mcp-mpv-player'
If you have feedback or need assistance with the MCP directory API, please join our Discord server