# 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**.

```powershell
$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
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).

## 2. Servidor MCP

```powershell
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