mpv-mcp-server

by arijit-gogoi

Not rated
GitHub

About

An mcp for mpv cross platform media player.

Details

Author
arijit-gogoi
Categories
Productivity, Media, Other

Setup

Install mpv-mcp-server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/arijit-gogoi/mpv-mcp-server

Follow the installation instructions in the repository README, then restart your MCP client.

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

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

{ "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
{ "mcpServers": { "mpv": { "command": "npx", "args": ["-y", "mpv-mcp-server"] } } }
{ "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" } } } }

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

YouTube tools requireyt-dlpon your PATH. Audio downloads also requireffmpeg.

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

The server communicates with mpv via itsJSON 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.

The World's First AI Music MCP Beyond images and video, your agent can now generate music.

Enables AI assistants to interact with DaVinci Resolve Studio for advanced control over video editing, color grading, and audio.

Transcribe and summarize video content from links using various transcription services.

: MCP server for AI media generation (imagesflux, videosveo3.1, music suno v5, with deterministic cost control using reserve-burn-refund billing

Create AI music videos and audio-reactive visuals from songs through MCP.

Turn any language model into a multimodal powerhouse that can generate images, music, videos and more on the fly. Rostro's tools are designed to be used by language models from the ground up, expanding capabilities with minimal context bloat.

All-in-one AI creative studio — generate videos, images, audio in 11 Indian languages, and 3D models via MCP. Hosted at mcp.arcframe.ai.

Official Cannon Studio MCP for AI video, image, 3D, audio, workflow, pricing, model, and developer API guidance.

A Python package for media processing using FFmpeg and FastMCP.

A server for creating fast and free lipsync videos for digital avatars, supporting both realistic and cartoon styles.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.