A
licenseNot graded
qualityD
maintenanceEnables control of Kodi media center through MCP protocol, supporting playback control, library management, navigation, and smart downloads search with automatic file playback.
5
MIT
yt-dlp-mcp
by yousong
Provides search, metadata retrieval, format listing, and downloading of media from Bilibili.
Enables discovery of Chromecast devices and casting media playback to them over the local network.
Enables discovery of DLNA devices and casting media playback to them over the local network.
Provides search, metadata retrieval, format listing, and downloading of media from SoundCloud.
Provides search, metadata retrieval, format listing, and downloading of media from YouTube.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@yt-dlp-mcpsearch for 'lofi hip hop' on YouTube and play the first result"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
yt-dlp-mcp
MCP (Model Context Protocol) 服务，封装 yt-dlp 能力，支持音频播放、搜索、下载、投屏。
能力
音频播放：通过 PulseAudio 实时播放媒体音频
搜索：支持 YouTube、SoundCloud、Bilibili 等多平台搜索
下载：下载媒体到指定目录，自动生成元信息文件
投屏：支持 DLNA、AirPlay、Chromecast 设备
Cookie 管理：持久化存储站点认证信息
Related MCP server: yarr-media-stack-mcp
快速开始
Docker 部署
# 构建镜像
docker compose build
# 启动服务
docker compose up -d
# 查看日志
docker compose logs -f
# 停止服务
docker compose down服务启动后监听 http://0.0.0.0:8080/mcp（Streamable HTTP transport）。
MCP 客户端连接地址：http://<host>:8080/mcp
配置
环境变量：
变量 | 默认值 | 说明 |
| (空) | PulseAudio 服务器地址，如 |
|
| mpv IPC socket 路径 |
|
| MCP transport 类型（streamable-http/stdio） |
|
| SSE 监听地址 |
|
| SSE 监听端口 |
|
| Cookie 存储目录 |
|
| 下载存储目录 |
| (空) | mpv 音频输出设备，如 |
音频输出配置
容器中没有默认音频设备。需要配置 PULSE_SERVER 连接到宿主机的 PulseAudio 服务器，或设置 YTDLP_MCP_MPV_AUDIO_DEVICE=null 进行测试（不实际播放音频）。
连接到 PulseAudio：
在宿主机上启动 PulseAudio 网络服务：
pactl load-module module-native-protocol-tcp auth-anonymous=1在 docker-compose.yml 中配置：
environment: PULSE_SERVER: "tcp:host.docker.internal:4713"
测试模式（无音频输出）：
environment:
YTDLP_MCP_MPV_AUDIO_DEVICE: "null"MCP 工具
工具 | 说明 |
| 播放媒体音频 |
| 控制播放（暂停/恢复/停止/跳转/音量） |
| 获取播放状态 |
| 获取媒体元信息 |
| 列出可用格式 |
| 搜索媒体 |
| 下载媒体 |
| 查询下载进度 |
| 列出已下载内容 |
| 读取下载元信息 |
| 发现投屏设备 |
| 投屏播放 |
| 设置站点 Cookie |
| 查询 Cookie |
| 删除 Cookie |
| 列出已存 Cookie 站点 |
网络说明
投屏功能（DLNA/AirPlay/Chromecast）需要 network_mode: host 以发现局域网设备。
开发
# 安装依赖
uv sync
# 运行测试
uv run pytest tests/
# 本地启动
YTDLP_MCP_COOKIE_DIR=/tmp/cookies YTDLP_MCP_STORE_DIR=/tmp/store uv run python -m yt_dlp_mcpThis server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues
Related MCP Connectors
Model Context Protocol server for Studex tools, notifications, and profile integrations
BGG MCP provides access to the BoardGameGeek API through the Model Context Protocol, enabling retr…
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables natural language control of self-hosted media services like Sonarr, Prowlarr, Overseerr, and Gotify through the Model Context Protocol.-
- AlicenseAqualityAmaintenanceEnables browser automation through the Model Context Protocol, allowing AI agents to control Chrome, Firefox, or Edge for tasks like navigation, clicking, typing, and screenshots.41267 npmMIT
- AlicenseAqualityCmaintenanceEnables searching, managing playlists, getting recommendations, and downloading music from TIDAL through natural language commands via the Model Context Protocol.16MIT