TV Box Tools

Configura cajas Android TV, Google TV y Fire TV mediante ADB en tu red: empareja, establece cualquier launcher como HOME, instala aplicaciones, capturas de pantalla y verificaciones.

GitHub

Documentación

TV Box Tools para Claude

Configura cajas Android TV, Google TV y Fire TV pidiéndoselo a Claude. El plugin le da a Claude el servidor MCP TV Box Tools y una habilidad que guía el proceso de configuración: encontrar la caja por Wi-Fi o USB, verificarla, instalar un launcher, hacerlo la aplicación HOME, probarlo tras un reinicio y mostrar un informe de cada comando ejecutado. Tú te quedas frente al televisor y solo pulsas lo que hay que pulsar allí (Permitir, elegir el launcher); Claude hace el resto desde tu computadora.

Lo que necesitas

Node.js 22 o más reciente en la computadora. No se instala nada más: el servidor y sus módulos están en este plugin.
Opciones de desarrollador y depuración en la caja de TV. La habilidad te indica cómo hacerlo para tu caja.
La computadora y el televisor en la misma red (Wi-Fi o cable).
Opcional: platform-tools de Google adb, para una caja por cable USB (su servidor adb transporta la conexión) y para el emparejamiento de Android 11+ "Depuración inalámbrica".

El servidor se ejecuta en tu computadora, por lo que el plugin funciona en Claude Code y en Cowork en la aplicación de escritorio. No funciona en el chat web ni en móvil, que no pueden alcanzar una caja en tu red doméstica.

El plugin configura una caja con Premium TV Launcher, o con cualquier launcher ya presente en la caja. Los televisores de hotel y alquiler (Hotel TV, modo kiosco) se configuran con la aplicación TV Box Tools: https://hoteltvapp.com/kiosk-manager/.

Instalación en Claude Code

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

Úsalo con cualquier cliente MCP

El servidor es un servidor MCP stdio estándar, por lo que también funciona en Claude Desktop, Cursor, VS Code, Windsurf y otros clientes MCP. Clona este repositorio y añádelo a la configuración MCP de tu cliente:

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

Usa la ruta completa donde lo clonaste (en Windows, las barras diagonales funcionan: C:/Users/you/tvboxtools-plugin/...). Otros clientes reciben las mismas nueve herramientas; la configuración guiada en skills/ está escrita para Claude.

Herramientas

Herramienta	¿Modifica la caja?	Qué hace
`discover`	no	Lista cajas por USB, por mDNS y mediante un escaneo de la red local /24 en el puerto TCP 5555
`pair`	no (empareja esta computadora)	Emparejamiento de depuración inalámbrica de Android 11+, a través de `adb pair` de Google
`connect`	no (el TV pide Permitir)	Abre la sesión ADB; el TV muestra "¿Permitir depuración USB?"
`check`	no	Modelo, versión de Android, aplicación HOME actual, launcher instalado, cuentas, espacio libre
`install`	sí	Instala las aplicaciones listadas en el manifiesto, tras verificar el SHA-256 de cada archivo
`provision`	sí	Instalar → establecer HOME (desactiva el launcher de fábrica con `pm disable-user`, datos conservados) → concesión de permisos → prueba. `dryRun: true` solo lista los comandos
`test`	sí (reinicia)	Tecla HOME, comprueba quién responde a HOME, captura de pantalla en la caja, reinicio
`screenshot`	no	PNG de lo que muestra el TV ahora
`report`	no	Cada comando de esta sesión con su resultado

No hay herramienta de shell sin procesar en este plugin (el servidor se ejecuta con --no-shell). Cada comando pasa por la misma puerta de lista de permitidos que la aplicación TV Box Tools, y comandos como restablecimiento de fábrica, borrado, su o desinstalación de aplicaciones del sistema se rechazan de plano. Para deshacer un cambio de launcher, usa Restaurar en la aplicación TV Box Tools: https://tvboxtools.com/restore/.

Qué ejecuta, envía y obtiene

Ejecuta: node server/tvboxtools.mjs --mcp --no-shell de este plugin. server/tvboxtools.mjs está compilado, sin minificar, a partir del código de código abierto en https://github.com/smartago/tvboxtools (Apache-2.0); los módulos que carga están en server/node_modules, copiados sin cambios de sus versiones de npm, cada uno con su licencia (lista: server/THIRD_PARTY.md). Nada se descarga ni se instala al iniciar el plugin. Para el emparejamiento de Android 11+ llama a adb pair de Google si platform-tools está instalado.
En tu red: USB, consultas mDNS, conexiones TCP al puerto 5555 de direcciones en tu /24 local (o la subred que nombres), la conexión ADB a la caja que elijas y un servidor adb local de Google en 127.0.0.1:5037 si uno está en ejecución.
Desde internet (solo para install y provision): el manifiesto de la aplicación desde https://tvboxtools.com/dl/manifest.json y los archivos APK que lista. Los APK se transmiten a la caja y no se guardan en la computadora.
Envía: nada a nosotros ni a nadie más. Sin telemetría, sin cuentas, sin análisis. El informe de sesión permanece en la memoria del servidor y desaparece cuando se detiene.
Almacena en tu computadora: su propia clave ADB en ~/.tvlm/ (para que el TV recuerde "Permitir siempre"). También lee ~/.android/adbkey si el adb de Google creó una, para que un TV que ya confía en tu adb no vuelva a preguntar.

Política de privacidad: https://tvboxtools.com/privacy/ · Términos: https://tvboxtools.com/terms/

Soporte

Problemas: https://github.com/smartago/tvboxtools/issues · Sitio web: https://tvboxtools.com

Hecho por Smartago. Apache-2.0.