TV Box Tools

Configure caixas Android TV, Google TV e Fire TV via ADB na sua rede: parear, definir qualquer launcher como HOME, instalar apps, capturas de tela e verificações.

GitHub

Documentação

TV Box Tools para Claude

Configure caixas Android TV, Google TV e Fire TV pedindo ao Claude. O plugin dá ao Claude o servidor MCP TV Box Tools e uma habilidade que orienta a configuração: encontrar a caixa via Wi-Fi ou USB, verificar, instalar um launcher, torná-lo o aplicativo HOME, testar após uma reinicialização e mostrar um relatório de cada comando executado. Você fica em frente à TV e só pressiona o que precisa ser pressionado lá (Allow, escolher o launcher); o Claude faz o resto a partir do seu computador.

O que você precisa

Node.js 22 ou mais recente no computador. Nada mais é instalado: o servidor e seus módulos estão neste plugin.
Opções de desenvolvedor e depuração na caixa de TV. A habilidade explica como fazer para a sua caixa.
O computador e a TV na mesma rede (Wi-Fi ou cabo).
Opcional: platform-tools do Google adb, para uma caixa via cabo USB (o servidor adb dele transporta a conexão) e para pareamento de "depuração sem fio" no Android 11+.

O servidor roda no seu computador, então o plugin funciona no Claude Code e no Cowork no aplicativo de desktop. Ele não roda no chat da web ou no celular, que não conseguem acessar uma caixa na sua rede doméstica.

O plugin configura uma caixa com o Premium TV Launcher, ou com qualquer launcher já presente na caixa. TVs de hotel e aluguel (Hotel TV, modo quiosque) são configuradas com o aplicativo TV Box Tools: https://hoteltvapp.com/kiosk-manager/.

Instalar no Claude Code

claude plugin marketplace add smartago/tvboxtools-plugin
claude plugin install tvboxtools@tvboxtools

Usar com qualquer cliente MCP

O servidor é um servidor MCP stdio simples, então também funciona no Claude Desktop, Cursor, VS Code, Windsurf e outros clientes MCP. Clone este repositório e adicione-o à configuração MCP do seu cliente:

{
  "mcpServers": {
    "tvboxtools": {
      "command": "node",
      "args": ["/path/to/tvboxtools-plugin/server/tvboxtools.mjs", "--mcp", "--no-shell"]
    }
  }
}

Use o caminho completo para onde você o clonou (no Windows, barras normais funcionam: C:/Users/you/tvboxtools-plugin/...). Outros clientes recebem as mesmas nove ferramentas; a configuração guiada em skills/ é escrita para o Claude.

Ferramentas

Ferramenta	Altera a caixa?	O que faz
`discover`	não	Lista caixas via USB, por mDNS e por varredura da rede local /24 na porta TCP 5555
`pair`	não (pareia este computador)	Pareamento de depuração sem fio no Android 11+, através do `adb pair` do Google
`connect`	não (a TV pede Allow)	Abre a sessão ADB; a TV mostra "Permitir depuração USB?"
`check`	não	Modelo, versão do Android, aplicativo HOME atual, launcher instalado, contas, espaço livre
`install`	sim	Instala os aplicativos listados no manifesto, após verificar o SHA-256 de cada arquivo
`provision`	sim	Instalar → definir HOME (desativa o launcher padrão com `pm disable-user`, dados mantidos) → concessões de permissão → teste. `dryRun: true` apenas lista os comandos
`test`	sim (reinicia)	Tecla HOME, verifica quem responde ao HOME, captura de tela na caixa, reinicialização
`screenshot`	não	PNG do que a TV mostra agora
`report`	não	Cada comando desta sessão com seu resultado

Não há ferramenta de shell bruto neste plugin (o servidor roda com --no-shell). Cada comando passa pelo mesmo filtro de lista de permissões que o aplicativo TV Box Tools, e comandos como redefinição de fábrica, wipe, su ou desinstalação de aplicativos do sistema são recusados de imediato. Para desfazer uma alteração de launcher, use Restore no aplicativo TV Box Tools: https://tvboxtools.com/restore/.

O que ele executa, envia e busca

Executa: node server/tvboxtools.mjs --mcp --no-shell deste plugin. server/tvboxtools.mjs é compilado, sem minificação, a partir do código de código aberto em https://github.com/smartago/tvboxtools (Apache-2.0); os módulos que ele carrega estão em server/node_modules, copiados sem alterações de suas versões npm, cada um com sua licença (lista: server/THIRD_PARTY.md). Nada é baixado ou instalado quando o plugin inicia. Para pareamento no Android 11+, ele chama o adb pair do Google se o platform-tools estiver instalado.
Na sua rede: USB, consultas mDNS, conexões TCP à porta 5555 de endereços na sua rede local /24 (ou na sub-rede que você indicar), a conexão ADB à caixa que você escolher e um servidor adb local do Google em 127.0.0.1:5037 se um estiver em execução.
Da internet (apenas para install e provision): o manifesto do aplicativo de https://tvboxtools.com/dl/manifest.json e os arquivos APK que ele lista. Os APKs são transmitidos para a caixa e não são salvos no computador.
Envia: nada para nós ou para qualquer outra pessoa. Sem telemetria, sem contas, sem análise. O relatório da sessão fica na memória do servidor e desaparece quando ele para.
Armazena no seu computador: sua própria chave ADB em ~/.tvlm/ (para a TV lembrar "Sempre permitir"). Ele também lê ~/.android/adbkey se o adb do Google criou um, para que uma TV que já confia no seu adb não pergunte novamente.

Política de privacidade: https://tvboxtools.com/privacy/ · Termos: https://tvboxtools.com/terms/

Suporte

Problemas: https://github.com/smartago/tvboxtools/issues · Site: https://tvboxtools.com

Feito por Smartago. Apache-2.0.