Iptv Org
БесплатноНе проверенFree linear TV: iptv-org discovery, health-filtered M3U playlists, EPG lookup, VLC + Jellyfin handoff. MCP server + Webapp
Описание
Free linear TV: iptv-org discovery, health-filtered M3U playlists, EPG lookup, VLC + Jellyfin handoff. MCP server + Webapp
README
FastMCP 3.4+ server for iptv-org: 8000+ public IPTV channels as searchable data + health-filtered M3U playlists. Solves the VLC dead-channel pain: filter by country/category, hide Geo-blocked/NSFW/blocklisted, optionally probe liveness, then play in VLC or import into Jellyfin Live TV.
Upstream stores no video, only public stream links (Unlicense/CC0). This server never proxies video. Blocklist + NSFW respected by default.
Quickstart
uv sync
copy .env.example .env
uv run pytest -q
uv run python -m iptv_org_mcp --serve --port 11242
Frontend:
cd web_sota
bun install
bun run dev
Or double-click start.bat (backend + frontend, ports 11242/11241).
Backend 11242, frontend 11241 (Vite dashboard: Channels, Playlists, EPG, Tools, Chat, Logs, Settings, Help). Health: http://127.0.0.1:11242/api/health.
MCP: http://127.0.0.1:11242/mcp (streamable HTTP) or stdio for Claude Desktop.
Claude Desktop
{
"mcpServers": {
"iptv-org": {
"command": "uv",
"args": ["run", "python", "-m", "iptv_org_mcp", "--mode", "stdio"],
"cwd": "D:/Dev/repos/iptv-org-mcp"
}
}
}
The VLC pain, fixed
iptv(operation="facets")- what countries/categories existiptv(operation="search_channels", query="ORF")- find, no dead weightiptv(operation="build_playlist", country="AT,DE", probe=true)- curated M3U URL- Paste URL into VLC (Media -> Open Network Stream) or
iptv(operation="play_in_vlc", channel_id="ORF1.at")on the same machine - Jellyfin:
iptv(operation="jellyfin_setup", country="AT")- M3U + XMLTV + steps
Docs
docs/ONBOARDING.md- no account needed (public CDN); VLC + Jellyfin setupdocs/TOOLS.md- all operations with examplesdocs/CONFIGURATION.md- env vars, cache, probe tuningINSTALL.md- naked-PC installdocs/TROUBLESHOOTING.md- dead streams, geo-blocks
Ports
| Port | Service |
|---|---|
| 11242 | Backend FastAPI + FastMCP /mcp |
| 11241 | Frontend (Vite dashboard) |
Registered in mcp-central-docs/operations/WEBAPP_PORTS.md.
Stack
Backend: Python 3.12+, FastMCP 3.4.x, FastAPI, uvicorn, httpx, pydantic v2,
prefab-ui. Frontend (web_sota/): React 19 + Vite 6 + TailwindCSS 3 +
Lucide + Framer Motion + Zustand + React Router, installed via Bun
(bun.lock committed; Node.js still required as Vite runs on Node).
Lint: ruff (T20) + pyright + biome + tsc. Tests: pytest (30% gate) + Playwright smoke.
MCP surface
Portmanteau iptv (12 ops: facets, search_channels, get_channel,
search_streams, check_streams, build_playlist, get_epg, jellyfin_setup,
play_in_vlc, status, refresh, help) plus iptv_shutdown, 2 prompts
(evening_news, match_night), 1 resource (resource://iptv-org/legal).
Legal
Only public links. blocklist.json (dmca/nsfw) enforced. See resource://iptv-org/legal.
MIT (this wrapper). Upstream: Unlicense/CC0.
Distribution (.mcpb bundle)
just mcpb-pack runs the fleet pack pipeline (wipe+recopy, import/AST/
pollution checks, 3-4-100 prompt gate, pack, launch-from-clean-unpack
proof) and writes dist/:
iptv-org-mcp-v0.2.1.mcpb- versioned archiveiptv-org-mcp.mcpb- stable name forreleases/latest/download/install.ps1- Claude Desktop one-liner installer (generated, SHA256-pinned)
Latest release (v0.2.1) carries all three assets. One-line install:
irm https://github.com/sandraschi/iptv-org-mcp/releases/latest/download/install.ps1 | iex
Установить Iptv Org в Claude Desktop, Claude Code, Cursor
unyly install iptv-orgСтавит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.
Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh
Или настроить вручную
Выполни в терминале:
claude mcp add iptv-org -- uvx --from git+https://github.com/sandraschi/iptv-org-mcp iptv-org-mcpПошаговые гайды: как установить Iptv Org
FAQ
Iptv Org MCP бесплатный?
Да, Iptv Org MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для Iptv Org?
Нет, Iptv Org работает без API-ключей и переменных окружения.
Iptv Org — hosted или self-hosted?
Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.
Как установить Iptv Org в Claude Desktop, Claude Code или Cursor?
Открой Iptv Org на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
Notion
Read and write pages in your workspace
автор: NotionLinear
Issues, cycles, triage — from Claude
автор: LinearGoogle Drive
Search and read your Drive files
автор: Googlemindsdb/mindsdb
Connect and unify data across various platforms and databases with [MindsDB as a single MCP server](https://docs.mindsdb.com/mcp/overview).
автор: mindsdbfulcradynamics/fulcra-context-mcp
Access personal health and biometric data (sleep stages, heart rate, HRV, glucose, workouts), calendar and location via the Fulcra Life API.
автор: fulcradynamicsrinadelph/Agent-MCP
Framework for building multi-agent systems that coordinate over MCP, with task management, shared context and RAG.
автор: rinadelphWhenLabs-org/when
Developer toolkit: stack detection for AI context files, port conflicts, .env schema validation, docs drift, dependency license audits and task timing.
автор: WhenLabs-orgBeltran12138/wecom-docs-mcp-server
WeCom (Enterprise WeChat) document operations via MCP: create, read, and edit Docs and Smartsheets (9 tools). Fills the doc-CRUD gap — existing WeCom MCP server
автор: Beltran12138freema/mcp-gsheets
Google Sheets API integration for reading, writing, formatting and sheet management.
автор: freemamattijsdp/dbt-docs-mcp
dbt-core (OSS) project metadata, model and column-level lineage, and dbt documentation.
автор: mattijsdpCompare Iptv Org with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории productivity
