mpv-mcp-server
About
Control mpv media player — playback, playlists, YouTube streaming, and downloads.
Use this server
Add it to your MCP client. The catalogue lists this config verbatim from its source — it does not run, download, or vouch for the server. Review the command before you run it.
Transportstdio (runs a local command)
Env vars
MPV_PATH MPV_IPC_PATH MPV_MEDIA_DIRS MPV_DOWNLOAD_DIRClaude Code
claude mcp add --env MPV_PATH= --env MPV_IPC_PATH= --env MPV_MEDIA_DIRS= --env MPV_DOWNLOAD_DIR= mpv-mcp-server -- npx mpv-mcp-server
Cursor
If the button doesn't open Cursor, use the JSON below — Cursor accepts the same mcpServers config.
VS Code
code --add-mcp '{"name":"mpv-mcp-server","command":"npx","args":["mpv-mcp-server"],"env":{"MPV_PATH":"","MPV_IPC_PATH":"","MPV_MEDIA_DIRS":"","MPV_DOWNLOAD_DIR":""}}'
JSON
{
"mcpServers": {
"mpv-mcp-server": {
"command": "npx",
"args": [
"mpv-mcp-server"
],
"env": {
"MPV_PATH": "",
"MPV_IPC_PATH": "",
"MPV_MEDIA_DIRS": "",
"MPV_DOWNLOAD_DIR": ""
}
}
}
}
Environment variables are listed by name only — fill in your own values. Entries never carry secrets.