Bootleg-Link MCP译为：Bootleg-Link 主机控制程序

Bootleg-Link MCP v0.7.0 Bootleg-Link MCP 是一个使用 Python 的 MCP 服务器，用于下载 YouTube 音频作为 MP3 文件，并自动嵌入封面艺术。它具有任务队列、并发下载管理器、基于 SQLite 的持久性和分页播放列表支持。

架构 单文件 Python MCP 服务器（src/server.py）通过 stdin/stdout 使用 JSON-RPC 2.0 进行通信。 任务队列：内存队列具有 SQLite 持久性，用于在重启时恢复 下载引擎：yt-dlp Python API，使用 bestaudio/best 格式 封面艺术：下载缩略图通过 writethumbnail，嵌入到 MP3 ID3 APIC 框架中使用 mutagen，然后清理 webp/webm 文件 并发性：ThreadPoolExecutor 具有可配置的工作线程数 分页播放列表：平面播放列表提取（每页 100 个）用于大型频道下载

MCP 工具 工具描述 submit_download_task 提交 YouTube URL/频道用于音频下载 query_progress 查询任务进度和状态 list_tasks 列出所有任务，具有可选状态过滤 cancel_task 取消待处理或运行中的任务 clear_completed 清理已完成/失败/取消的任务 get_queue_status 获取队列指标（活动、排队、总计） submit_download_task { "url": "https://www.youtube.com/@ChannelName/videos", "quality": "320", "outputDir": "/path/to/output" } 返回：{ "success": true, "taskId": "task_xxx", "status": "pending" } query_progress { "taskId": "task_xxx" } 返回：{ "status": "downloading", "progress": 45, "songsCompleted": 5, "songsTotal": 100 }

依赖 yt-dlp — YouTube 音频提取 mutagen — MP3 ID3 标签操作和封面艺术嵌入 Python 3.10+（stdlib 只：sqlite3、json、threading、concurrent.futures）

安装 pip install yt-dlp mutagen

配置 配置文件：~/.bootleg-link-mcp/config.json { "paths": { "outputDir": "~/Downloads/bootleg-link", "dbPath": "~/.bootleg-link-mcp/bootleg-link.db" }, "proxy": { "http": "http://proxy:port", "https": "http://proxy:port" }, "download": { "maxConcurrent": 4, "quality": "320" } } 或通过 OpenClaw MCP 配置使用环境变量（已弃用，使用 config.json）： { "command": "/path/to/python3", "args": ["src/server.py"], "env": { "BOOTLEG_OUTPUT_DIR": "/mnt/e/downloads", "BOOTLEG_HTTP_PROXY": "http://proxy:1081", "BOOTLEG_HTTPS_PROXY": "http://proxy:1081" } }

开发 # 运行测试（67 个测试用例） /opt/pyenv/versions/3.11.8/bin/python3 test_mcp.py # 直接运行服务器 /opt/pyenv/versions/3.11.8/bin/python3 src/server.py