← Back to browse

mpv-mcp-server

Indexed by io.github.arijit-gogoi

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 varsMPV_PATH MPV_IPC_PATH MPV_MEDIA_DIRS MPV_DOWNLOAD_DIR
Claude 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

Add to 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.