SERVER

mpv-mcp-server

Rank #52,666

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

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

2 versions

1 GitHub stars

by arijit-gogoi (1 servers)View repository ↗Claim this server

Listed & last published

Apr 12, 2026

OVERVIEW

mpv-mcp-server is a Model Context Protocol (MCP) server published by arijit-gogoi. It ranks #52,666 of 137,492 servers tracked on MCP Toplist, and its repository has 1 GitHub stars. mpv-mcp-server is listed across 3 registries — Official MCP, PulseMCP and Glama, with 2 tracked versions. It was first listed on Apr 12, 2026 and most recently updated on Apr 12, 2026.

STANDING

#52,666of 137,492 tracked serversTop 50%

Ranks ahead of 84,826 of 137,492 servers on MCP Toplist.

CONNECT

Use mpv-mcp-server

No setupRuns out of the box

No credentials or required configuration declared — add it to your MCP client and go.

npm package

claude mcp add mpv-mcp-server -e "MPV_PATH=<your MPV_PATH>" -e "MPV_IPC_PATH=<your MPV_IPC_PATH>" -e "MPV_MEDIA_DIRS=<your MPV_MEDIA_DIRS>" -e "MPV_DOWNLOAD_DIR=<your MPV_DOWNLOAD_DIR>" -- npx -y mpv-mcp-server

Replace each placeholder with your own value before saving.

npm package

[mcp_servers.mpv-mcp-server]
command = "npx"
args = ["-y", "mpv-mcp-server"]

[mcp_servers.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>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

npm package

{
  "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>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

npm package

{
  "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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

npm package

{
  "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>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

npm package

{
  "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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

npm package

{
  "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>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/io.github.arijit-gogoi%2Fmpv-mcp-server.svg)](https://mcptoplist.com/server/io.github.arijit-gogoi%2Fmpv-mcp-server)

HTML

<a href="https://mcptoplist.com/server/io.github.arijit-gogoi%2Fmpv-mcp-server"><img src="https://mcptoplist.com/badge/io.github.arijit-gogoi%2Fmpv-mcp-server.svg" alt="MCP Toplist: Top 50% of 137,492" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

REGISTRIES

Listed on 3 registries

Official MCP

PulseMCP

Glama

ORGANIZATION

arijit-gogoi

Organization

arijit-gogoi

Servers in org

Versions across org

VERSIONS

Available versions (2)

Version	Published
1.2.0	Apr 12, 2026
1.1.1	Apr 12, 2026

FAQ

Frequently asked questions

Who maintains mpv-mcp-server?: mpv-mcp-server is maintained by arijit-gogoi, which publishes 1 MCP server (2 total versions) tracked on MCP Toplist.
Is mpv-mcp-server listed on the Official MCP Registry?: Yes — mpv-mcp-server is listed on the Official MCP Registry, alongside PulseMCP and Glama.
How many versions does mpv-mcp-server have?: MCP Toplist tracks 2 versions of mpv-mcp-server, most recently published on Apr 12, 2026.
Where can I find the source code for mpv-mcp-server?: The source code for mpv-mcp-server is hosted at github.com/arijit-gogoi/mpv-mcp-server.

Used in projects

Do you run this server?

Add to a project

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Official MCP Servers GitHub MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers