Skip to main content
Glama
StreamGPT Local MCP
by utb2017

StreamGPT Local desktop interface. Preview uses explicitly labeled sample devices.

Your TVs, within reach

StreamGPT Local is a Rust companion for the StreamGPT TV remote. Link your account to bring local Roku and LG TVs into the same remote as your existing Samsung connection, including authenticated ChatGPT control. Use the guided Add a TV flow on your computer, then control connected TVs from ChatGPT on your phone. The native process handles discovery, pairing, encrypted storage and commands. Tauri uses the operating system's webview instead of shipping Chromium or Node.js.

  • Find your screens. Bounded SSDP discovery on private IPv4 interfaces, with manual address entry available in setup help.

  • Approve access. LG pairing happens on the TV. On Roku, select Settings > System > Advanced system settings > Control by mobile apps > Network access > Enabled. Ordinary remote buttons do not require Developer Mode.

  • Keep control local. Pairing credentials and the command journal are encrypted using a key held by the OS credential store.

  • Follow the setup. One Add a TV flow shows candidates, connection requests and actual activity. Choosing a TV and connecting it are separate steps; successful pairing is followed by a read-only status check.

  • Connect your AI. The account-linked assistant reuses StreamGPT's resident agent. Buttons work without inference. Built-in stdio MCP also exposes four focused tools for desktop clients.

  • Know what happened. Durable request IDs prevent duplicate delivery. Missing acknowledgements remain uncertain; commands are never automatically retried.

Early preview: real Roku discovery/enrollment/status and LG on-TV approval plus a read-only status request have been observed. A Roku Express 4K+ running OS 15.3.4 reported network control set to Limited; user Play requests reached the helper, but their physical effects were not confirmed. Successful status reads do not prove button permission. Automated control tests use fixtures. The screenshot is a labeled preview. Roku's current ECP documentation restricts third-party platforms; availability of this source does not grant permission to distribute a commercial Roku remote. See compatibility.

Related MCP server: webos-tv

Get started

  1. Download the Windows installer from Releases. This preview is not code-signed; Windows may show an unknown-publisher warning. Check the published SHA-256 before installing.

  2. Open StreamGPT Local. Keep the computer and TV on the same home network. Ethernet and Wi-Fi both work when the router permits them to communicate.

  3. Click Add a TV, then choose Samsung, LG or Roku. The app walks you through the steps for that TV.

  4. For ChatGPT control, choose Connect to ChatGPT when prompted. Your browser opens automatically. Sign in to the same StreamGPT account used in ChatGPT, compare the displayed code and click Approve this computer. The code is for comparison; you do not type it.

  5. Return to the app and click Find TVs for LG/Roku. Choose the TV from the results, then explicitly click Connect TV. Approve the LG TV prompt if it appears. Samsung setup guides you through SmartThings instead.

  6. For Roku, set Settings > System > Advanced system settings > Control by mobile apps > Network access > Enabled using the Roku remote. If you change it after connecting, use Check status in StreamGPT to refresh the permission reading.

  7. The app reads status after connection. Your saved TVs appear on Your TVs; select one to use from ChatGPT or open its desktop remote. No remote button is sent as an automatic test.

The setup shows search progress, results and an explicit empty or failed result. This computer is selected automatically when available. Need help? reveals guidance and optional assistant chat.

Standalone computer control remains under Settings ? Use remote on this computer. Manual address entry is in setup help; Desktop MCP and connection diagnostics are under Settings.

The app must remain open and the computer awake. No router port forwarding, vendor account password or paid cloud service is required for local operation. Power-on from standby, arbitrary app launching and media streaming are not included.

Desktop MCP

The executable supports --mcp. The app generates the correct executable path for your installation; do not copy another user's absolute path.

Tool

Purpose

discover_tvs

Find nearby LG/Roku devices and names without pairing or sending remote commands

list_tvs

List devices explicitly approved in the desktop app

get_tv_status

Read a paired TV's status

press_tv_button

Send one allowlisted button, with a required UUID request ID

The MCP child process connects to an authenticated loopback endpoint owned by the running desktop app. It can discover devices, but cannot enroll, pair or forget them. Pairing keys are never returned in tool output. AI clients can use discovery to guide setup; this desktop app does not run a separate language model.

ChatGPT on your phone: link this helper to the same StreamGPT account connected in ChatGPT. The PC must remain awake, connected to the TV's network and running the helper; closing its window keeps it in the system tray. Quit in the tray stops the helper. Only outbound HTTPS/WSS is used, with expiring credentials and no router forwarding. Existing Samsung grants are preserved. Phone ChatGPT does not scan your LAN itself.

iPhone companion: the shared Rust/mobile source, permissions template and build instructions are prepared. Mac/Xcode signing and physical-device testing are still required; no iOS download is offered yet. See the iOS handoff. Do not rely on the phone app remaining a bridge while iOS suspends it.

Development

Requirements: Node.js 22+, Rust stable and the Tauri platform prerequisites. Windows uses the MSVC toolchain and WebView2. The Windows installer can bootstrap WebView2 if needed.

npm ci
npm run dev
npm run typecheck
npm run build
npm run test:ui-model
cargo test --manifest-path src-tauri/Cargo.toml
cargo fmt --manifest-path src-tauri/Cargo.toml --check
npm run dist

For a UI-only preview without touching a network or TV:

npm run preview
# Open http://127.0.0.1:5198/?demo=1

Windows installers are the initial supported distribution. macOS/Linux code paths are not release-validated. Build output, credential stores and local configuration are excluded from this repository.

Design and engineering

  • Black and neutral surfaces, a tactile directional pad, clear approval states and explicit empty states.

  • A single serialized controller for UI and MCP; durable reservation precedes any button dispatch.

  • Private IPv4 targets only. Discovery never follows a responder-supplied URL.

  • LG certificate pinning on first approved pairing; subsequent connections must use the same certificate. Older TVs may use plaintext WebSockets on the trusted LAN.

  • Deny-by-default remote webview access. The renderer has no general shell, filesystem or network capability.

See architecture, security, and research for the details and tradeoffs.

Credits

Created by Aaron Tomlinson. Original interface and Rust implementation. Research informed by Roku's ECP documentation, the MIT-licensed lgtv2 protocol documentation, and existing community MCP projects. This project is not affiliated with LG, Roku, OpenAI or Samsung.

MIT licensed. Vendor names identify compatible protocols; they are not endorsements.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to control a set-top streaming device and visually navigate its interface, including opening apps, managing playback, entering text, adjusting volume and power, sending remote input, and capturing screenshots for observation and verification.
      14
      42 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables an AI agent to control an LG webOS TV by reading playback status, listing and launching apps, adjusting volume or mute, and powering it off.
      MIT
    • 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.
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an AI agent or script to control Android TV and LG webOS devices over streamable HTTP, including key presses, app launches, power and wake, input switching, sleep timers, toasts, status checks, screenshots, and device scans, with bearer-token authentication and an app denylist.
      GPL 3.0