youtube_helper.mcp module

youtube-helper: Model Context Protocol (MCP) surface.

A thin adapter that exposes the FastAPI app from youtube_helper.api as MCP tools, so any MCP-aware host (an agent runtime, an IDE integration, a custom shell) can call the yt-dlp-backed operations — resolving direct media URLs, browsing stream catalogs, downloading video/audio/thumbnails/subtitles, and pulling no-API engagement metadata (channel/video/comments) across YouTube, Vimeo, DailyMotion, Twitch VOD, SoundCloud, and any yt-dlp-supported source — as first-class tools. Uses fastapi-mcp (https://github.com/tadata-org/fastapi_mcp): one wrapper publishes the whole existing HTTP surface, so the routes are never duplicated.

Install the extra to pull in fastapi-mcp:

pip install "youtube-helper[mcp]"

Then run the server (HTTP API + MCP endpoint at /mcp):

youtube-helper-mcp                 # console entry point
python -m youtube_helper.mcp       # equivalent

Author

Warith Harchaoui, Ph.D. — https://linkedin.com/in/warith-harchaoui/

youtube_helper.mcp.main()

Console entry point (youtube-helper-mcp): serve the API + MCP endpoint.

Boots the FastAPI app (now serving both the /... HTTP routes and the /mcp MCP endpoint) with uvicorn in a single worker. Local-first: binds to loopback by default (override with YOUTUBE_HELPER_HOST / YOUTUBE_HELPER_PORT).

Return type:

None