JinDaGe - mcp_youtube_dlp MCP Details

article

README

🚀 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",
        "<install path>/mcp_youtube_dlp/main.py"
      ],
      "env": {
        "YT_DLP_PATH": "/usr/local/bin/yt-dlp",
        "DEFAULT_DOWNLOAD_DIR": "~/Downloads/youtube_downloads"
      }
    }
  }
}

请将 <install path> 替换为您实际安装此包的路径。

可用工具

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 网站。

mcp_youtube_dlp