MCP Media Player Server

Steuere einen Mediaplayer über Home Assistant.

GitHub

Dokumentation

MCP Media Player

You could just watch one episode. Or you could automate the pause button and pretend you have self-control. MCP Media Player connects any Home Assistant media player (TV, projector, speaker, etc.) to the Cursor coding environment. Play media while your agent works; when it's done, so is your break.

Dopamine-driven development, minus the binge-watching.

Features

  • Exposes play and pause controls for a media player as MCP tools
  • Integrates with Home Assistant's media player API
  • Provides Cursor rules for automating playback while the agent is working

Requirements

  • Node.js 18 or higher (for native fetch and ES modules)
  • A running Home Assistant instance
  • A valid Home Assistant long-lived access token

Setup

  1. Clone the repository

  2. Install dependencies

npm install
  1. Configure MCP integration

Copy mcp.json.example to your MCP config location (e.g., ~/.cursor/mcp.json) and fill in your real values:

{
  "mcpServers": {
    "MediaPlayer": {
      "command": "node",
      "args": [
        "/absolute/path/to/your/media-player-mcp.js"
      ],
      "env": {
        "HA_URL": "http://your-ha-url:8123",
        "HA_TOKEN": "your_home_assistant_long_lived_token",
        "ENTITY_ID": "media_player.your_media_player_entity"
      }
    }
  }
}
  1. Add Cursor rules for automation

To automate the play/pause while the agent is working, copy the rules in cursor-rules.example into your Cursor rules configuration. This configures a system prompt rule that ensures the play/pause tools are called at the appropriate times.

  1. Start the MCP server
npm start

Or, let your MCP client launch it automatically.

License

MIT