YouTube视频下载工具

一个基于MCP协议的服务器工具,提供下载YouTube视频和音频的功能,支持MP4和MP3格式,并可集成到AI助手中。

  • by yorickchan
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 yorickchan/mcp_youtube_dlp

使用说明

MCP YouTube DLP

一种模型上下文协议(MCP)服务器,提供使用yt-dlp下载YouTube视频和音频的工具。

特性

  • 下载MP4格式的YouTube视频
  • 下载MP3格式的YouTube音频
  • 与MCP集成,实现AI助手集成

先决条件

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

安装

  1. 克隆此存储库
  2. 安装依赖项:
pip install -e .

或使用紫外线:

uv pip install -e .

用法

运行服务器

启动MCP服务器:

python main.py

服务器将在启用调试的stdio模式下启动。

环境变量

  • 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> 使用安装此软件包的实际路径。

可用工具

下载_ youtube _视频

下载MP4格式的YouTube视频。

参数:

  • url:YouTube视频URL

退货:

  • 成功或错误消息

下载_ youtube_audio

下载MP3格式的YouTube视频音频。

参数:

  • url:YouTube视频URL

退货:

  • 成功或错误消息

MCP集成

该服务器实现了模型上下文协议,允许AI助手访问下载YouTube内容的工具。服务器可以连接到任何兼容MCP的客户端。

许可证

本项目根据GNU通用公共许可证第2版(GPL-2.0)获得许可-请参阅 GNU网站 了解详情。