# 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**
```sh
npm install
```
3. **Configure MCP integration**
Copy `mcp.json.example` to your MCP config location (e.g., `~/.cursor/mcp.json`) and fill in your real values:
```json
{
"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"
}
}
}
}
```
4. **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.
5. **Start the MCP server**
```sh
npm start
```
Or, let your MCP client launch it automatically.
## License
MIT
