🚀 MCP YouTube-DLP 服务器
本项目是一个基于 Model Context Protocol (MCP) 的服务器，借助 yt-dlp 工具，可实现 YouTube 视频与音频的下载功能，为用户提供便捷的内容获取途径。
🚀 快速开始
本服务器以标准输入输出模式运行，并启用调试功能，使用前需确保满足先决条件，然后按安装步骤操作，最后运行服务器即可开始使用。
✨ 主要特性
- 🎬 支持将 YouTube 视频下载为 MP4 格式。
- 🎵 支持将 YouTube 音频下载为 MP3 格式。
- 🤖 与 MCP 整合，可支持 AI 助手集成。
📦 安装指南
先决条件
- 需安装 Python 3.13 或更高版本。
- 系统上已安装 yt-dlp。
安装步骤
- 克隆此仓库。
- 安装依赖，可选择以下任意一种方式：
pip install -e .
或使用 uv：
uv pip install -e .
💻 使用示例
运行服务器
启动 MCP 服务器：
python main.py
环境变量
YT_DLP_PATH：yt-dlp 可执行文件的路径（默认值：/usr/local/bin/yt-dlp）DEFAULT_DOWNLOAD_DIR：下载视频的默认目录（默认值：~/Downloads/youtube_downloads）
MCP 配置
在您的 MCP 设置中添加以下配置：
{
"mcpServers": {
"mcp_youtube_dlp": {
"command": "uvx",
"args": [
"mcp[cli]",
"run",
"/mcp_youtube_dlp/main.py"
],
"env": {
"YT_DLP_PATH": "/usr/local/bin/yt-dlp",
"DEFAULT_DOWNLOAD_DIR": "~/Downloads/youtube_downloads"
}
}
}
}
请将
可用工具
download_youtube_video
下载 YouTube 视频为 MP4 格式。 参数：
url：YouTube 视频 URL 返回：- 成功或错误消息
download_youtube_audio
下载 YouTube 视频的音频为 MP3 格式。 参数：
url：YouTube 视频 URL 返回：- 成功或错误消息
🔧 技术细节
此服务器实现了 Model Context Protocol，允许 AI 助手访问用于下载 YouTube 内容的工具。该服务器可以连接到任何与 MCP 兼容的客户端，通过与 MCP 的整合，为 AI 助手提供了便捷的 YouTube 内容下载功能。
📄 许可证
本项目根据 GNU 通用公共许可证第 2 版（GPL - 2.0）授权，详情请参阅 GNU 网站。