MCP.Market

Mpv MCP server

by arijit-gogoi·io.github.arijit-gogoi/mpv-mcp-server·v1.2.0·1 stars
No reviews yet

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

B82/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
New

1 stars51 downloads/wk

Reviews

Write one

Nobody has reviewed Mpv yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Mpv tools (17, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • mpv_add

    Add a file to the playlist by path or search term. Use mode "append-play" to start playing it immediately.

  • mpv_browse

    List available music and video files. Optionally filter by search term or directory.

  • mpv_download

    Download audio or video from YouTube. Specify format: "audio" for MP3, "video" for full video.

  • mpv_info

    Get metadata (artist, title, album, genre, etc.) for a file by search term, or the currently playing track if omitted.

  • mpv_load_playlist

    Load a playlist file (.txt, .m3u). Omit path to list available playlists.

  • mpv_next

    Skip to the next track in the playlist.

  • mpv_pause

    Pause the currently playing track.

  • mpv_play

    Play a file by path or search term. Searches your Music and Videos folders when given a name like "sultans of swing".

  • mpv_playlist

    Show the current playlist with track numbers and the active track marked.

  • mpv_prev

    Go back to the previous track in the playlist.

  • mpv_resume

    Resume playback if paused.

  • mpv_seek

    Seek to a position. Accepts seconds ("90"), timestamp ("1:30"), or relative ("+10", "-30").

  • mpv_status

    Get current mpv playback status: track title, position, duration, volume, and pause state.

  • mpv_stop

    Stop playback and clear the current file. The playlist is preserved.

  • mpv_tagwrite action

    Write metadata tags to a media file using ffmpeg. Can target a file by search term. Infers artist/title from the filename if not provided.

  • mpv_volume

    Get or set the playback volume. Provide a level (0-150) to set, or omit to get current volume.

  • mpv_youtube

    Search YouTube and stream the result through mpv. Accepts a search query or a direct YouTube URL.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan39 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 168 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Mpv compares

Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 65% of 1,337 Media servers
Tools
17
the typical Media server has 7
Tools that change things
6%
typical: 4%. Fewer write tools means less an agent can break
GitHub stars
1
more than 55% of 715 Media servers
Downloads a week
51
more than 38% of 365 Media servers with a package

What its tools let an agent do: 16 read · 1 change

Install Mpv in Claude Code, Cursor or VS Code

Runs npx -y mpv-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mpv-mcp-server -- npx -y mpv-mcp-server
Add to Cursor

What the publisher says

From the Mpv repository's README, as published. We do not edit it. Read it on GitHub

mpv-mcp-server

MCP server for controlling mpv media player. Browse your music library, control playback, stream from YouTube, and download tracks — all from inside an MCP client like Claude Code.

Prerequisites

  • mpv — media player (must be on your PATH, or set MPV_PATH)
  • Node.js 22+
  • yt-dlp (optional) — required for YouTube streaming and downloading
  • ffmpeg (optional) — required for audio extraction, metadata reading (ffprobe), and tagging

Quick Start

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "mpv": {
      "command": "npx",
      "args": ["-y", "mpv-mcp-server"]
    }
  }
}

Or add at user scope (available in all projects):

claude mcp add mpv --scope user -- npx -y mpv-mcp-server

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "mpv": {
      "command": "npx",
      "args": ["-y", "mpv-mcp-server"]
    }
  }
}

With environment overrides

{
  "mcpServers": {
    "mpv": {
      "command": "npx",
      "args": ["-y", "mpv-mcp-server"],
      "env": {
        "MPV_PATH": "/usr/local/bin/mpv",
        "MPV_MEDIA_DIRS": "/home/user/Music,/home/user/Podcasts",
        "MPV_DOWNLOAD_DIR": "/home/user/Music"
      }
    }
  }
}

Configuration

All configuration is via environment variables. Everything has sensible defaults.

Tools

Playback

Library

YouTube

YouTube tools require yt-dlp on your PATH. Audio downloads also require ffmpeg.

Metadata

Both tools infer artist/title from the "Artist - Title" filename pattern. Requires ffmpeg (includes ffprobe).

How It Works

The server communicates with mpv via its JSON IPC protocol. On Windows this uses a named pipe, on macOS/Linux a Unix domain socket. If mpv isn't running, the server spawns it automatically in idle mode. The mpv process is detached, so it keeps playing even if the MCP server exits.

Platform Support

Developed and tested on Windows. macOS/Linux support is implemented but untested — issues and PRs welcome!

License

MIT

Nothing above is checked by us. What we check is on the safety report.

Mpv: common questions

Is Mpv MCP server safe?
Mostly: it is graded B (82/100). Read the Mpv safety report
How do I install Mpv?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Mpv need an API key?
No secret keys are declared. It reads 4 settings from the environment.
Is Mpv maintained?
The last commit was 206 days ago (2026-04-12). The latest release is v1.2.0.
What can I use instead of Mpv?
Servers from other publishers that do the same job: Youtube Transcript MCP server, transcript1 MCP server and Openshorts MCP server.
How does Mpv compare with other Media MCP servers?
safety score 82/100 (higher than 65% of 1,337 Media servers); tools 17 (the typical Media server has 7); tools that change things 6% (typical: 4%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Mpv

Same job from other publishers: the closest match first, then the best rated.

  • Youtube Transcript
    This is an MCP server that allows you to directly download transcripts of YouTube videos.
    B
  • transcript1
    Transcribe YouTube, TikTok, Instagram, X and 7 more social media platforms, or audio/video files.
    A
  • Openshorts
    Turn long videos into viral vertical shorts and publish them to TikTok, Instagram and YouTube.
    A
  • Transloadit Media Processing
    Process video, audio, images and documents with Transloadit Robots. Connect by URL with OAuth.
    A
  • SuperCMO
    Marketing media generation — image, video, voice — for AI agents. BYO keys.
    B