mcp-mpv-player
Control mpv media player through AI conversation. Play music and video, manage playlists — all via natural language. Works with opencode and any MCP-compatible AI tool.
README
mcp-mpv-player
Control mpv media player through AI conversation. Play music and video, manage playlists — all via natural language.
Works with opencode and any MCP-compatible AI tool.
Installation
Make sure Node.js is installed, then run:
npx mcp-mpv-player
The setup wizard will automatically:
- Detect or install mpv
- Locate your opencode config file
- Register the MCP tool
Restart opencode when done.
Usage Examples
Just talk to your AI naturally:
Play D:/Music/song.mp3
Pause
Next track
Skip forward 30 seconds
Jump to 2 minutes 30 seconds
Set volume to 80
Create a playlist called "chill" with D:/Music/a.mp3 and D:/Music/b.mp3
Play the "chill" playlist
Shuffle
Tools
Playback Control
| Tool | Description |
|---|---|
player_play |
Play a file or URL, auto-starts mpv |
player_pause |
Toggle pause / resume |
player_stop |
Stop playback |
player_next |
Next track |
player_prev |
Previous track |
player_seek |
Seek by seconds / absolute time / percent |
player_set_volume |
Set volume (0–130) |
player_set_speed |
Set playback speed (0.5x / 1x / 2x …) |
player_status |
Get current playback status |
player_shuffle |
Shuffle playlist and play from the start |
Playlist Management
| Tool | Description |
|---|---|
playlist_create |
Create a new playlist |
playlist_load |
Load and play a saved playlist |
playlist_add |
Add files to a playlist |
playlist_remove |
Remove a track from a playlist |
playlist_list |
List all playlists or inspect one |
playlist_delete |
Delete a playlist |
Playlists are saved as .m3u files in %USERPROFILE%\mpv-playlists\.
Requirements
- Windows 10 / 11
- Node.js 18+
- mpv (can be installed automatically by the setup wizard)
How It Works
mpv exposes a JSON IPC interface via a Windows Named Pipe (\\.\pipe\mpv-ipc). This tool runs as an MCP server, receives commands from the AI, and forwards them to mpv.
When player_play is called and mpv is not running, it is launched automatically with the IPC flag and stays running in the background between tracks.
License
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.