Skip to main content
Glama
Sign In
mcp-tv-cast

mcp-tv-cast

by Osouzaa
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

mcp-tv-cast

Ferramentas para mostrar a tela do PC (Windows) numa TV com pouco atraso, sem depender do Win + K.

English: tools to mirror a Windows PC screen to a TV with low latency. A "bridge" PC connected to the TV by HDMI receives the video over UDP (FFmpeg → ffplay); plus an MCP server to control Android TV / Samsung TVs.

O projeto tem duas partes independentes:

Parte

Para quê

Ponte de tela (scripts PowerShell)

Um PC ligado à TV por HDMI recebe a tela de outros PCs pela rede e a exibe em tela cheia, com tela de espera.

Servidor MCP (src/index.ts)

Ferramentas para um assistente (Claude etc.) controlar TVs: Miracast, Samsung (Tizen) e Android TV por ADB.

1. Ponte de tela

PC de origem ── FFmpeg (captura + encoder de hardware) ──UDP──▶ PC-ponte ── ffplay em tela cheia ──HDMI──▶ TV

Por que assim: TVs baratas decodificam vídeo mal e o Miracast (Wi-Fi Direct) costuma falhar. Com um PC de verdade na ponta o atraso fica pequeno, e o UDP não forma fila: o que não dá para exibir é descartado.

Requisitos

  • Windows 10/11 nos dois PCs, na mesma rede. winget disponível (para instalar o FFmpeg).

  • Origem: GPU Intel (QSV), NVIDIA ou AMD para o encoder de hardware (há fallback por software).

  • Ponte: acesso de administrador (para a regra de firewall) apenas na instalação.

Configuração

Copie config.exemplo.ps1 para config.local.ps1 e preencha com os valores da sua rede. Esse arquivo não é versionado.

$Ponte         = "192.0.2.10"      # IP da máquina-ponte
$FaixaLiberada = "192.0.2.0/24"    # quem pode enviar vídeo para a ponte

Instalar a ponte (uma vez, como administrador, na máquina-ponte)

powershell -ExecutionPolicy Bypass -File .\receber-tela-ponte.ps1 -IniciarComWindows

Instala o FFmpeg, libera UDP 5004 apenas para a faixa informada, grava o receptor e cria o atalho "Receber tela". Quando ninguém transmite, a TV mostra uma tela de espera (nome, relógio, data, passos); ao começar a transmissão ela vira vídeo sozinha e, ao parar, volta para a espera. O visual fica em tema.json (nome, cores, logos) e pode ser aplicado com -TemaJson. Veja tema.exemplo.json. Outras opções: -AdicionarIp, -Remover (cabeçalho do script).

Transmitir

  • Transmitir-Tela\Transmitir-Tela.bat: duplo clique, escolhe a tela e a qualidade (para quem só usa).

  • espelhar-ponte.ps1 -Tela 1|2|3: uso direto, 1080p/60 fps por padrão.

A numeração das telas segue a ordem de captura do Windows (DXGI), que pode diferir da numeração do painel de vídeo. Se aparecer a tela errada, tente outro número.

Limitações

  • Sem áudio. Uma pessoa por vez.

  • O vídeo vai sem criptografia pela rede local (veja Segurança).

Related MCP server: adb-tv-mcp

2. Servidor MCP

npm install
npm run build
npm run inspect          # opcional: testar no MCP Inspector
claude mcp add tv-cast -- node C:\caminho\mcp-tv-cast\dist\index.js

Ferramenta

O que faz

diagnosticar_miracast, listar_displays_sem_fio, abrir_painel_transmitir, modo_projecao

Apoio ao Miracast / Win + K / Win + P

ligar_tv, samsung_tecla

Wake-on-LAN e controle de TV Samsung (Tizen)

instalar_ferramentas

Instala adb e scrcpy via winget

tv_conectar, tv_dispositivos, tv_info, tv_listar_apps

Android TV por ADB: conexão e diagnóstico

tv_otimizar, tv_reativar_app

Limpa cache, reduz animações, desativa apps (reversível)

tv_tecla, tv_abrir_app, tv_reiniciar, tv_miracast_receber, tv_espelhar

Controle remoto, receptor Miracast e espelhamento com scrcpy

Variáveis opcionais: ADB_PATH, SCRCPY_PATH. Android TV: ative Depuração USB/ADB e Depuração de rede nas opções do desenvolvedor.

Segurança

  • Este repositório não contém IPs, nomes de máquina, senhas ou logos. Tudo isso fica em arquivos locais ignorados pelo Git (config.local.ps1, tema.local.json, logos/). Não os envie.

  • A ponte só aceita UDP da faixa que você definir. O filtro é por IP, sem autenticação nem criptografia: qualquer máquina dessa faixa pode enviar imagem para a TV, e o vídeo pode ser visto por quem capturar o tráfego da rede. Use em redes confiáveis e peça autorização ao responsável pela rede antes de instalar.

  • O MCP executa comandos (adb, PowerShell) no seu PC: use somente com assistentes e TVs em que você confia.

Licença

MIT, veja LICENSE.

mcp-ponte-tv

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers

  • lg-tv-mcp

    OmerLapidot
    A
    license
    Not graded
    quality
    D
    maintenance
    Turns AI assistants like Claude and ChatGPT into a remote control for LG webOS smart TVs, enabling power control, volume, app launching, input switching, and more, all locally without cloud APIs.
    5
    MIT

  • adb-tv-mcp

    mosesmrima
    A
    license
    B
    quality
    C
    maintenance
    Enables AI agents to control Android TV/Android devices through ADB, including screen capture, remote control, app management, and more.
    24
    26 npm
    3
    MIT

  • samsung-tv-mcp

    dwdas9
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables Claude to control a Samsung Tizen smart TV over the local network without cloud services, covering power on/off, launching and closing apps, casting YouTube videos, sending remote keys, adjusting volume, and checking TV status and health.
    1
    MIT

  • vibetv

    Uchebuzz
    A
    license
    Not graded
    quality
    C
    maintenance
    Gives AI coding agents eyes and hands on a TV: capture the screen as an image, press remote keys, type text, read console logs and JS errors, deploy projects, launch apps, and apply or revert system tweaks across Android TV, Google TV, Fire TV, Roku and LG webOS. This lets an agent design, live-check and iterate on a custom ad-free home screen directly on the big screen.
    1
    MIT