A
license-
qualityD
maintenanceMCP control for foobar2000. Control your music player with an AI assistant!
6
MIT
mcp-mpv-player
by guodaxia9527
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.
Related MCP server: social-video-mcp
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
–Maintainers
–Response time
–Release cycle
1Releases (12mo)
Commit activity
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that enables AI agents to play and control YouTube and TikTok videos through a native mpv player window. It supports browsing subscriptions, searching content, managing playlists, and fetching video metadata using authenticated browser cookies.2384MIT
- Alicense-qualityCmaintenanceVideo player for humans and AI. GUI + CLI + a built-in MCP server (39 tools) to drive playback, clip, transcribe, and search your media library from Claude, Cursor, or any MCP client. Local Whisper subtitles. MIT, local-first.MIT
- AlicenseAqualityCmaintenanceMCP server that enables natural language control of internet radio from Claude Code, with access to 30,000+ global stations, auto-playback via mpv, and a real-time status line with audio spectrum visualization.7MIT
Related MCP Connectors
Generate AI music via the Lacuna Music API from MCP clients like Claude Desktop & Code.
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
MCP server for Producer/Riffusion AI music generation
Appeared in Searches
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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