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

Name: io.github.arijit-gogoi/mpv-mcp-server MCP Server
Author: io.github.arijit-gogoi

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

Repository Registry

What is the io.github.arijit-gogoi/mpv-mcp-server MCP server?

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

How to install io.github.arijit-gogoi/mpv-mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mpv-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mpv-mcp-server"
      ],
      "env": {
        "MPV_PATH": "<YOUR_MPV_PATH>",
        "MPV_IPC_PATH": "<YOUR_MPV_IPC_PATH>",
        "MPV_MEDIA_DIRS": "<YOUR_MPV_MEDIA_DIRS>",
        "MPV_DOWNLOAD_DIR": "<YOUR_MPV_DOWNLOAD_DIR>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mpv-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mpv-mcp-server"
      ],
      "env": {
        "MPV_PATH": "<YOUR_MPV_PATH>",
        "MPV_IPC_PATH": "<YOUR_MPV_IPC_PATH>",
        "MPV_MEDIA_DIRS": "<YOUR_MPV_MEDIA_DIRS>",
        "MPV_DOWNLOAD_DIR": "<YOUR_MPV_DOWNLOAD_DIR>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mpv-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mpv-mcp-server"
      ],
      "env": {
        "MPV_PATH": "<YOUR_MPV_PATH>",
        "MPV_IPC_PATH": "<YOUR_MPV_IPC_PATH>",
        "MPV_MEDIA_DIRS": "<YOUR_MPV_MEDIA_DIRS>",
        "MPV_DOWNLOAD_DIR": "<YOUR_MPV_DOWNLOAD_DIR>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mpv-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mpv-mcp-server"
      ],
      "env": {
        "MPV_PATH": "<YOUR_MPV_PATH>",
        "MPV_IPC_PATH": "<YOUR_MPV_IPC_PATH>",
        "MPV_MEDIA_DIRS": "<YOUR_MPV_MEDIA_DIRS>",
        "MPV_DOWNLOAD_DIR": "<YOUR_MPV_DOWNLOAD_DIR>"
      }
    }
  }
}

Claude Code

claude mcp add mpv-mcp-server --env MPV_PATH=<YOUR_MPV_PATH> --env MPV_IPC_PATH=<YOUR_MPV_IPC_PATH> --env MPV_MEDIA_DIRS=<YOUR_MPV_MEDIA_DIRS> --env MPV_DOWNLOAD_DIR=<YOUR_MPV_DOWNLOAD_DIR> -- npx -y mpv-mcp-server