convez.ai
MCP ServerAutomaçãoIntermediário
rj45johnson

Roku MCP — Controle de TV Roku via Claude

rj45johnson/roku-mcp

Controle local de TV Roku via CLI e MCP, sem nuvem

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que permite controlar uma TV Roku diretamente da linha de comando ou do Claude, sem nuvem, sem conta Roku e sem chaves de API. Comunica-se localmente via ECP (External Control Protocol) na porta 8060, com descoberta automática de dispositivos via SSDP.

Instalação

$npx convez-ai rj45johnson/roku-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automatizar comandos de TV (launch apps, navegação, busca)
  • Integrar Roku com fluxos de automação residencial local
  • Controlar TV via Claude em arquitetura sem internet na nuvem
  • Scriptear rotinas de inicialização de aplicativos por comando de voz/texto

Veredito

Solução sólida e minimalista para automação doméstica local. Requisito crítico: ativar controle por redes móveis nas configurações da TV, senão comandos retornam 403. Excelente para quem busca eliminar dependência de nuvem.

README

A tradução para o português deste README ainda está na fila.

roku-mcp

Control a Roku TV from the command line and from any MCP client (Claude, etc.) over your local network — no cloud, no Roku account, no API keys. Pure Roku ECP on port 8060.

  • 🔌 Zero cloud — talks directly to the TV on your LAN
  • 🐍 Stdlib-only CLI — roku.py has no dependencies
  • 🤖 MCP server — roku_mcp.py exposes 9 tools to Claude and other MCP clients
  • 🔎 Auto-discovery — finds Rokus via SSDP, falls back to a subnet probe

Quick start (CLI)

python roku.py discover                 # find Rokus on your network
python roku.py info                     # device name, model, power state
python roku.py launch netflix           # open an app by name
python roku.py search "The Bear"        # global search + select first result
python roku.py key Down Down Select      # raw remote keys

Set a default device so you can skip --ip:

# Windows
setx ROKU_IP 192.168.1.50
# macOS/Linux
export ROKU_IP=192.168.1.50

MCP server (Claude Desktop / Claude Code)

pip install "mcp[cli]"

Add to your MCP config (.mcp.json for Claude Code, or the Claude Desktop config):

{
  "mcpServers": {
    "roku": {
      "command": "python",
      "args": ["/path/to/roku_mcp.py"],
      "env": { "ROKU_IP": "192.168.1.50" }
    }
  }
}

Then just ask: "launch Netflix on the Roku" or "search for The Bear on the TV."

Tools: discover_rokus, set_device, get_status, list_apps, launch_app, press_keys, power_on, power_off, search_and_play.

Heads-up: enable local control on the TV

Control commands (launch/navigate/power) require the TV's local API to be open:

Settings → System → Advanced system settings → Control by mobile apps → Network access → Default

If it's set to Limited, status queries work but commands return 403 Forbidden. This is a Roku firmware setting — there is no bypass, and this tool doesn't attempt one.

License

MIT

Ver o original no GitHub

Bom para

Relacionados