YouTube MCP Server 使用说明

项目简介

本项目是一个 MCP (Model Context Protocol) 服务器,旨在为大型语言模型 (LLM) 提供访问 YouTube 视频内容的能力。它通过集成 'yt-dlp' 工具,允许 LLM 客户端请求并获取指定 YouTube 视频的字幕和元数据,从而增强 LLM 对视频内容的理解和处理能力。

主要功能点

  • 获取 YouTube 字幕: 支持多种语言的 YouTube 字幕下载,使 LLM 能够理解视频对话内容。
  • 获取视频元数据: 提供视频标题和描述信息,帮助 LLM 更好地理解视频主题和背景。
  • 标准 MCP 协议: 遵循 MCP 协议标准,易于集成到支持 MCP 协议的 LLM 客户端。
  • 使用简单: 配置和使用过程简洁明了,方便用户快速上手。

安装步骤

  1. 安装 'yt-dlp': 'yt-dlp' 是用于下载 YouTube 字幕和元数据的命令行工具。请根据您的操作系统选择合适的安装方式。

    • macOS (Homebrew): 打开终端并运行 'brew install yt-dlp'
    • Windows (WinGet): 打开 PowerShell 并运行 'winget install yt-dlp'
    • 或者参考 yt-dlp releases 下载安装。
  2. 全局安装 MCP YouTube Server: 使用 npm (Node.js 包管理器) 全局安装 '@kazuph/mcp-youtube' 包。

    • 打开终端或命令提示符,运行命令:'npm install -g @kazuph/mcp-youtube'

服务器配置

为了让 MCP 客户端(如 Claude)连接到此 MCP 服务器,您需要在客户端配置中添加以下服务器信息。这通常是一个 JSON 格式的配置文件。

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-youtube"]
    }
  }
}

配置参数说明:

  • '"youtube"': 服务器名称,可以自定义,用于在客户端中引用此服务器。
  • '"command": "npx"': 启动服务器的命令,'npx' 用于执行本地或全局安装的 npm 包。
  • '"args": ["-y", "@kazuph/mcp-youtube"]': 传递给 'npx' 的参数。
    • '"-y"': 'npx' 参数,表示自动确认执行包。
    • '"@kazuph/mcp-youtube"': 要执行的 npm 包名,即 MCP YouTube Server。

基本使用方法

配置完成后,在支持 MCP 协议的 LLM 客户端中,您可以通过调用 'get_youtube_transcript' 工具来获取 YouTube 视频的字幕和元数据。

例如,在 Claude 中,您可以这样提问:

'Summarize the YouTube video <<YouTube视频URL>>'

或者更明确地指示 Claude 使用 'get_youtube_transcript' 工具:

'Use the "get_youtube_transcript" tool to get the transcript of <<YouTube视频URL>> and summarize it.'

LLM 客户端会解析您的请求,识别需要使用 YouTube MCP 服务器,并自动调用 'get_youtube_transcript' 工具,将 YouTube 视频 URL 作为参数传递给服务器。服务器会返回视频的字幕和元数据,LLM 客户端即可利用这些信息完成您的指令。

注意:

  • 确保 'yt-dlp' 已正确安装并可在命令行中运行。
  • 字幕语言默认为日语 ('ja'),您可以通过修改服务器代码或扩展工具参数来支持更多语言选项。
  • 如果指定的语言字幕不存在,服务器会返回错误信息。

信息

分类

网页与API