MCP Media Player

Controlar um reprodutor de mídia via Home Assistant.

Documentação

MCP Media Player

Você poderia simplesmente assistir a um episódio. Ou poderia automatizar o botão de pausa e fingir que tem autocontrole. O MCP Media Player conecta qualquer media player do Home Assistant (TV, projetor, caixa de som, etc.) ao ambiente de codificação Cursor. Reproduza mídia enquanto seu agente trabalha; quando ele terminar, sua pausa também termina.

Desenvolvimento movido a dopamina, sem maratonar séries.

Recursos

  • Expõe controles de reprodução e pausa para um media player como ferramentas MCP
  • Integra-se com a API de media player do Home Assistant
  • Fornece regras do Cursor para automatizar a reprodução enquanto o agente está trabalhando

Requisitos

  • Node.js 18 ou superior (para fetch nativo e módulos ES)
  • Uma instância do Home Assistant em execução
  • Um token de acesso de longa duração válido do Home Assistant

Configuração

  1. Clone o repositório

  2. Instale as dependências

npm install
  1. Configure a integração MCP

Copie mcp.json.example para o local de configuração do MCP (por exemplo, ~/.cursor/mcp.json) e preencha com seus valores reais:

{
  "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. Adicione regras do Cursor para automação

Para automatizar a reprodução/pausa enquanto o agente está trabalhando, copie as regras em cursor-rules.example para a configuração de regras do Cursor. Isso configura uma regra de prompt do sistema que garante que as ferramentas de reprodução/pausa sejam chamadas nos momentos apropriados.

  1. Inicie o servidor MCP
npm start

Ou deixe seu cliente MCP iniciá-lo automaticamente.

Licença

MIT