Chromecast / DLNA casting (catt) MCP server

catt-mcp

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

MCP server for casting YouTube videos and media to Chromecast/DLNA devices via catt.

Exposes 15 tools covering YouTube casting, playback control, dual-screen sync, and device discovery.

Demo

Recorded on the real network with docs/demo/record.sh: a minimal MCP client (docs/demo/mcpdemo.py) starts the server over stdio with CATTDEVICE in the environment, lists the tools and calls cast_scan (read-only). Private IP addresses are replaced with documentation addresses.

Tools

<!-- tools:start -->

<!-- tools:end -->

YouTube ID extraction

extractvideoid (URL watch?v=, youtu.be/, shorts/ or a bare 11-character ID, anything else rejected before it reaches catt/ADB) is deliberately duplicated in pylips-mcp (youtubevideo, TV app with Premium account). Both servers stay installable on their own; each one tests its copy with the same table of cases (tests/testyoutubeid.py). Decision recorded on 2026-09-20.

Requirements

• Python 3.10+
• catt: pip install catt
• yt-dlp: pip install yt-dlp
• A Chromecast or DLNA-compatible device on the same network
• lz4 (optional, for cache compression): pip install lz4

Dual cast (Linux + Hyprland)

castbrowser, castbrowserdual, castdualresync, castdualstop and castdualoffset drive Firefox from the running desktop session. They are advertised only** when the required binaries are present:

• Hyprland with hyprctl in PATH
• playerctl for MPRIS playback control
• Firefox holding the video to mirror
• lz4 (Python) to read Firefox's session cache

Without them the server starts normally and simply does not expose these five tools, instead of failing when they are called.

Installation en une ligne

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

Configuration Claude Desktop / Claude Code (mcpServers) :

{ "catt": { "command": "uvx", "args": ["catt-mcp"], "env": { "CATT_DEVICE": "Living Room TV" } } }

Setup

1. Install dependencies

pip install mcp catt yt-dlp

2. Discover your device

Shortened. The full README is on GitHub.