使用说明

项目简介

本项目 'mcp-youtube' 是一个基于 Model Context Protocol (MCP) 的服务器实现,它扩展了LLM的能力,使其能够获取YouTube视频的字幕和元数据。通过这个服务器,LLM可以理解YouTube视频的内容,从而实现视频摘要、内容分析等应用场景。

主要功能点

  • YouTube字幕提取: 通过URL即可提取YouTube视频的字幕内容,支持指定字幕语言。
  • YouTube元数据获取: 获取视频的标题和描述等基本信息。
  • MCP标准工具: 以MCP工具的形式提供上述功能,方便LLM客户端集成和调用。
  • 易于集成: 使用标准的JSON-RPC over Stdio协议,可以轻松集成到任何支持MCP协议的LLM客户端。

安装步骤

  1. 安装 'yt-dlp': 'mcp-youtube' 服务器依赖 'yt-dlp' 工具来下载YouTube视频信息。请根据您的操作系统选择合适的安装方式。

    • macOS (Homebrew):

      brew install yt-dlp
    • Windows (WinGet):

      winget install yt-dlp
  2. 安装 Node.js 和 npm (或 npx): 确保您的系统已安装 Node.js 和 npm (或 npx,通常 npm 自带 npx)。

服务器配置

为了让MCP客户端能够连接到 'mcp-youtube' 服务器,您需要在客户端的配置文件中添加以下服务器配置信息。通常,MCP客户端会读取一个JSON格式的配置文件,例如 'mcp-config.json'。

以下是一个示例配置,您可以将其添加到您的MCP客户端配置文件中。请注意,您无需修改或运行任何命令,只需将以下JSON配置复制到您的MCP客户端配置文件中即可。

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

配置参数说明:

  • '"youtube"': 服务器名称,您可以自定义,客户端通过此名称引用该服务器。
  • '"command": "npx"': 启动服务器的命令。 'npx' 是 npm 包管理器自带的工具,用于执行本地或远程的 npm 包。
  • '"args": ["-y", "@kazuph/mcp-youtube"]': 传递给 'npx' 命令的参数。
    • '"-y"': 'npx' 的参数,表示自动同意安装 '@kazuph/mcp-youtube' 包(如果尚未安装)。
    • '"@kazuph/mcp-youtube"': 要执行的 npm 包名称,即 'mcp-youtube' 服务器的入口。

重要提示: MCP客户端会负责启动和管理 'mcp-youtube' 服务器进程,您无需手动启动服务器。您只需要在客户端配置文件中提供正确的服务器配置信息即可。

基本使用方法

配置完成后,您的MCP客户端应该能够识别并使用 'mcp-youtube' 服务器提供的工具。

例如,如果您的LLM客户端是 Claude,您可以尝试向 Claude 提出类似以下指令的问题:

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

其中 '<<视频URL>>' 替换为您想要分析的YouTube视频链接。

在幕后,当 Claude 遇到这种指令时,它可能会通过MCP协议调用 'mcp-youtube' 服务器提供的 'get_youtube_transcript' 工具,获取视频的字幕和元数据,然后利用这些信息来完成摘要或其他相关任务。

您也可以更明确地指示 Claude 使用 'get_youtube_transcript' 工具,具体指令格式取决于您的MCP客户端的实现。通常,您需要提供工具名称和必要的参数,例如视频URL和字幕语言代码(可选)。

工具名称: 'get_youtube_transcript'

工具参数示例 (JSON 格式):

{
  "url": "https://www.youtube.com/watch?v=your_video_id",
  "language": "en" // 可选,例如 "en" (英语), "ja" (日语), "zh" (中文) 等, 默认为 "ja"
}

请参考您的MCP客户端的文档,了解如何更详细地调用和使用 'mcp-youtube' 服务器提供的工具。

信息

分类

网页与API