使用说明

项目简介

YouTube MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器应用,旨在为大型语言模型 (LLM) 应用提供访问 YouTube 视频信息的接口。通过该服务器,LLM 应用可以获取 YouTube 视频的元数据、提取视频字幕,并将字幕转换为 Markdown 格式,以便更好地理解和处理视频内容。

主要功能点

  • 获取视频元数据: 提取 YouTube 视频的标题、描述、发布日期、频道信息等详细元数据。
  • 提取视频字幕: 支持自动生成字幕和手动上传字幕的提取,并支持多种语言字幕。
  • 字幕转 Markdown: 将视频字幕转换为 Markdown 格式,并提供多种内置模板(基本、详细、搜索高亮)以满足不同场景的需求。
  • 字幕搜索: 支持在视频字幕中搜索关键词,并高亮显示搜索结果及其上下文。
  • 灵活的认证方式: 支持 YouTube API 密钥和 OAuth2 两种认证方式,可以访问公开和私有视频。

安装步骤

  1. 克隆仓库
    git clone [repository-url]
    cd youtube-mcp
  2. 安装依赖
    npm install
  3. 构建项目
    npm run build

服务器配置

要将 YouTube MCP Server 集成到 MCP 客户端,您需要在客户端的 MCP 服务器配置文件中添加以下配置信息。请根据您的实际环境修改 'command' 和 'args' 中的路径,并将 YouTube API 密钥等凭据填入 'env' 中。

{
  "mcpServers": {
    "youtube": {
      "command": "node",
      "args": ["path/to/youtube-mcp/build/index.js"], // 请替换为 youtube-mcp 项目 build 目录下的 index.js 文件的实际路径
      "env": {
        "YOUTUBE_API_KEY": "YOUR_YOUTUBE_API_KEY", // 您的 YouTube API 密钥 (必需,用于访问公开视频)
        "YOUTUBE_CLIENT_ID": "YOUR_YOUTUBE_CLIENT_ID",   // 您的 YouTube OAuth2 客户端 ID (可选,用于访问私有视频)
        "YOUTUBE_CLIENT_SECRET": "YOUR_YOUTUBE_CLIENT_SECRET", // 您的 YouTube OAuth2 客户端密钥 (可选,用于访问私有视频)
        "YOUTUBE_REFRESH_TOKEN": "YOUR_YOUTUBE_REFRESH_TOKEN" // 您的 YouTube OAuth2 刷新令牌 (可选,用于访问私有视频)
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

基本使用方法

在 MCP 客户端中,您可以使用以下 'use_mcp_tool' 命令来调用 YouTube MCP Server 提供的工具:

  • 获取视频信息

    use_mcp_tool youtube get_video_info {
      "url": "https://www.youtube.com/watch?v=VIDEO_ID"
    }
  • 获取视频字幕

    use_mcp_tool youtube get_captions {
      "url": "https://www.youtube.com/watch?v=VIDEO_ID",
      "language": "en" // 可选,默认为 "en"
    }
  • 转换为 Markdown 格式

    use_mcp_tool youtube convert_to_markdown {
      "url": "https://www.youtube.com/watch?v=VIDEO_ID",
      "template_name": "detailed" // 可选,可选 "basic", "detailed", 或 "search"
    }
  • 列出可用模板

    use_mcp_tool youtube list_templates

请将 'VIDEO_ID' 替换为实际的 YouTube 视频 ID。

信息

分类

网页与API