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.
Power your agent
Perintah milik penerbit sendiri. Bukan endpoint PlugMCP.
Host a copy with our keys and logs.
uvx pylips-mcp==0.4.0Claude Code tidak punya tautan instal untuk perintah lokal. Salin perintah di bawah dan jalankan di terminal.
TV_HOST=<value> TV_USER=<value> TV_PASS=<secret> DENON_HOST=<value> DENON_PORT=<value> PYLIPS_TLS_FINGERPRINT=<value> claude mcp add io.github.amineutron-pylips-mcp -- uvx pylips-mcp==0.4.0Jalankan di terminal.
{ "mcpServers": { "io.github.amineutron-pylips-mcp": { "command": "uvx", "args": [ "pylips-mcp==0.4.0" ], "env": { "TV_HOST": "<value>", "TV_USER": "<value>", "TV_PASS": "<secret>", "DENON_HOST": "<value>", "DENON_PORT": "<value>", "PYLIPS_TLS_FINGERPRINT": "<value>" } } }}claude_desktop_config.json
URL remote atau perintah di mesin Anda? Perbedaan kedua cara instal
Jalankan di PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
BukaDari penerbit
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.
Control a Philips Android TV over JointSpace and ADB: power, volume, apps, keys, screen, Ambilight.

Recorded against the real TV with docs/demo/record.sh: a minimal MCP client (docs/demo/mcp_demo.py) starts the server over stdio with TV_HOST/TV_USER/TV_PASS in the environment, lists the tools and calls get_state (read-only). Credentials never appear on screen.
extract_video_id is deliberately duplicated in catt-mcp (cast_youtube, 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/test_youtube_id.py). Decision recorded on 2026-09-20.
wakeonlan Python package (optional, for Wake-on-LAN)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": "..." } } }
Pairing is done once, to get a JointSpace user and password. Use the pairing tool of
eslavnov/pylips from a clone of that repository
(the pylips package on PyPI is an unrelated project: do not pip install pylips),
and follow its README with your TV's IP. pylips-mcp does not need pylips afterwards.
Keep the user and password the pairing gives you: they go into config.yaml (step 3) or TV_USER / TV_PASS.
pip install pylips-mcp # or: uvx pylips-mcp
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-mcp # installed (pip, uvx) ; `pylips-mcp --help` lists the settings
python -m pylips_mcp # same thing, from any environment where the package is installed
python server.py # from a clone, without installing (thin launcher, code in pylips_mcp/)
Or set via environment variables:
TV_HOST=192.168.0.XX TV_USER=xxx TV_PASS=xxx pylips-mcp
The code lives in the pylips_mcp package (with the TP Vision certificate), so it can be
installed next to other MCP servers without module name clashes.
{
"mcpServers": {
"philips-tv": {
"command": "python3",
"args": ["/path/to/pylips-mcp/server.py"],
"env": {
"TV_HOST": "192.168.0.XX",
"TV_USER": "your_user",
"TV_PASS": "your_password"
}
}
}
}
Philips TVs present a TP Vision certificate chain from 2015 signed with SHA1.
Modern OpenSSL and the Fedora/RHEL crypto policy reject SHA1 signatures, so a
classic CA verification is impossible, even with the bundled chain and
SECLEVEL=0.
What this server does instead, honestly:
tpvision_ca.pem (checked by urllib3 after the
TLS handshake, so a man-in-the-middle cannot impersonate the TV without the
private key). Verified against a real 55OLED705 (JointSpace 6, port 1926);PYLIPS_TLS_FINGERPRINT=<sha256 hex> pins another TV, PYLIPS_TLS_PIN=0
disables pinning and logs a warning.tpvision_ca.pem is the public TP Vision chain (leaf restfultv.tpvision.com,
intermediate ca.tpvision.com, root www.tpvision.com, valid until 2042),
extracted from a TV with openssl s_client -showcerts. It contains no secret.
MIT
Quand la TV est reliee a un ampli en HDMI ARC, le son ne sort pas de la TV :
agir sur son volume n'a aucun effet audible. Si denon.host est renseigne
dans la configuration, volume_up, volume_down, volume_set et mute
sont donc rediriges vers l'ampli Denon ; sinon ils passent par l'API de la TV.
Pour piloter l'ampli directement (entrees, extinction, statut), utiliser denon-mcp.
Control a Philips Android TV over JointSpace and ADB: power, volume, apps, keys, screen, Ambilight.
{ "mcpServers": { "io.github.amineutron-pylips-mcp": { "command": "uvx", "args": [ "pylips-mcp==0.4.0" ], "env": { "TV_HOST": "<value>", "TV_USER": "<value>", "TV_PASS": "<secret>", "DENON_HOST": "<value>", "DENON_PORT": "<value>", "PYLIPS_TLS_FINGERPRINT": "<value>" } } }}Tool
Belum ada daftar tool. Server remote mendapatkannya setelah pemeriksaan kesehatan pertama.
FAQ
Salin konfigurasi stdio untuk Cursor, Claude Desktop, Claude Code, atau VS Code di halaman ini. Konfigurasi ini memakai instalasi dari penerbit, bukan proxy PlugMCP.
Penerbit mencantumkan variabel lingkungan berikut: TV_HOST, TV_USER, TV_PASS, DENON_HOST, DENON_PORT, PYLIPS_TLS_FINGERPRINT.
Philips TV (JointSpace + ADB) berjalan secara lokal melalui stdio.
Terakhir diperiksa 2026-11-09. Control a Philips Android TV over JointSpace and ADB: power, volume, apps, keys, screen, Ambilight.