mpv-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MPV_PATH | No | Path to mpv executable | mpv |
| MPV_IPC_PATH | No | IPC socket path | \.\pipe\mpvpipe on Windows, /tmp/mpv-ipc.sock on Unix |
| MPV_MEDIA_DIRS | No | Comma-separated media directories to scan | ~/Music,~/Videos |
| MPV_DOWNLOAD_DIR | No | Where downloaded files are saved | ~/Downloads |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| mpv_statusA | Get current mpv playback status: track title, position, duration, volume, and pause state. |
| mpv_playA | Play a file by path or search term. Searches your Music and Videos folders when given a name like "sultans of swing". |
| mpv_pauseA | Pause the currently playing track. |
| mpv_resumeA | Resume playback if paused. |
| mpv_stopA | Stop playback and clear the current file. The playlist is preserved. |
| mpv_nextA | Skip to the next track in the playlist. |
| mpv_prevA | Go back to the previous track in the playlist. |
| mpv_seekA | Seek to a position. Accepts seconds ("90"), timestamp ("1:30"), or relative ("+10", "-30"). |
| mpv_volumeA | Get or set the playback volume. Provide a level (0-150) to set, or omit to get current volume. |
| mpv_playlistA | Show the current playlist with track numbers and the active track marked. |
| mpv_addA | Add a file to the playlist by path or search term. Use mode "append-play" to start playing it immediately. |
| mpv_load_playlistA | Load a playlist file (.txt, .m3u). Omit path to list available playlists. |
| mpv_browseA | List available music and video files. Optionally filter by search term or directory. |
| mpv_youtubeA | Search YouTube and stream the result through mpv. Accepts a search query or a direct YouTube URL. |
| mpv_downloadA | Download audio or video from YouTube. Specify format: "audio" for MP3, "video" for full video. |
| mpv_infoA | Get metadata (artist, title, album, genre, etc.) for a file by search term, or the currently playing track if omitted. |
| mpv_tagA | Write metadata tags to a media file using ffmpeg. Can target a file by search term. Infers artist/title from the filename if not provided. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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/arijit-gogoi/mpv-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server