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

替换 `` 使用安装此软件包的实际路径。

可用工具

下载\_ youtube \_视频

下载MP4格式的YouTube视频。

参数：

• url：YouTube视频URL

退货：

• 成功或错误消息

下载\_ youtube_audio

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

参数：

• url：YouTube视频URL

退货：

• 成功或错误消息

MCP集成

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

许可证

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