io.github.arijit-gogoi/mpv-mcp-server

MCP

by arijit-gogoi · v1.2.0

Control mpv media player — playback, playlists, YouTube streaming, and downloads.

mcplocal

MCP configuration

stdio

Command

npx -y mpv-mcp-server@1.2.0

Environment

  • MPV_PATH

    Path to mpv executable (default: mpv from PATH)

  • MPV_IPC_PATH

    IPC socket path (default: named pipe on Windows, Unix socket on macOS/Linux)

  • MPV_MEDIA_DIRS

    Comma-separated media directories to scan (default: ~/Music,~/Videos)

  • MPV_DOWNLOAD_DIR

    Download directory for YouTube downloads (default: ~/Downloads)

Install in one click with Zurek

Browse here, install from the native macOS app — pick targets, fill env vars, and write configs safely.