Philips TV (JointSpace + ADB) MCP server

pylips-mcp

<!-- mcp-name: io.github.amineutron/pylips-mcp -->

MCP server for controlling Philips Android TV via the JointSpace API and ADB.

Exposes 14 tools covering power, volume, ambilight, app launching, and YouTube playback. Handles the TP Vision SHA1 certificate chain transparently.

Demo

Recorded against the real TV with docs/demo/record.sh: a minimal MCP client (docs/demo/mcpdemo.py) starts the server over stdio with TVHOST/TVUSER/TVPASS in the environment, lists the tools and calls get_state (read-only). Credentials never appear on screen.

Tools

<!-- tools:start -->

<!-- tools:end -->

YouTube ID extraction

extractvideoid is deliberately duplicated in catt-mcp (castyoutube, Chromecast with start position and dual-screen sync). Both servers stay installable on their own; each one tests its copy with the same table of cases (tests/testyoutube_id.py). Decision recorded on 2026-09-20.

Requirements

• Python 3.10+
• pylips installed and accessible
• Philips Android TV with JointSpace API enabled (2016+ models)
• ADB enabled on the TV (for YouTube deep linking)
• wakeonlan Python package (optional, for Wake-on-LAN)

Installation en une ligne

uvx pylips-mcp                 # depuis PyPI ; avant publication : uvx --from git+https://github.com/amineutron/pylips-mcp pylips-mcp

Configuration Claude Desktop / Claude Code (mcpServers) :

{ "pylips": { "command": "uvx", "args": ["pylips-mcp"], "env": { "TV_HOST": "192.0.2.10", "TV_USER": "...", "TV_PASS": "..." } } }

Setup

1. Pair with your TV

pip install pylips
python -m pylips --host 192.168.0.XX --init

This generates credentials saved in ~/.config/pylips/pylips.conf.

2. Install dependencies

pip install mcp requests wakeonlan

3. Configure

Copy config.example.yaml to config.yaml and fill in your TV credentials:

tv:
  host: "192.168.0.XX"
  user: "your_user"
  pass: "your_password"

pylips_path: "/path/to/pylips"  # or set PYLIPS_PATH env var

4. Run

python server.py

Or set via environment variables:

TV_HOST=192.168.0.XX TV_USER=xxx TV_PASS=xxx python server.py

Claude Desktop Configuration

Shortened. The full README is on GitHub.