MCP YouTube-DLP 服务器

一个提供工具用于使用 yt-dlp 下载 YouTube 视频和音频的 Model Context Protocol (MCP) 服务器。

功能

• 下载 YouTube 视频为 MP4 格式
• 下载 YouTube 音频为 MP3 格式
• 与 MCP 整合以支持 AI 助手集成

先决条件

• Python 3.13 或更高版本
• 系统上已安装 yt-dlp

安装

1. 克隆此仓库
2. 安装依赖：

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

返回：

• 成功或错误消息

MCP 集成

此服务器实现 Model Context Protocol，允许 AI 助手访问用于下载 YouTube 内容的工具。该服务器可以连接到任何与 MCP 兼容的客户端。

许可证

本项目根据 GNU 通用公共许可证第 2 版（GPL-2.0）授权 - 详情请参阅 GNU 网站。