Roku MCP — Controle de TV Roku via Claude
rj45johnson/roku-mcp
Controle local de TV Roku via CLI e MCP, sem nuvem
Ver no GitHubServidor 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-mcp1 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
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.pyhas no dependencies - 🤖 MCP server —
roku_mcp.pyexposes 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