YouTube Watch Later MCP Server

YouTube Watch Later MCP Server

用于访问YouTube稍后观看播放列表的MCP Server。

smithery 徽章

这是一个 MCP 服务器,让您可以访问自定义 YouTube 播放列表中的视频链接。

安装

选项 1:通过 Smithery 自动安装 (推荐)

npx -y @smithery/cli install youtube-watchlater --client claude

选项 2:手动安装

git clone https://github.com/rados10/youtube-watchlater-mcp.git
cd youtube-watchlater
npm install
npm run build

设置步骤

1. 创建 Google Cloud 项目

  • 前往 Google Cloud 控制台
  • 创建新项目并启用 YouTube Data API v3
  • 创建 OAuth 2.0 客户端 ID (Web 应用类型)
  • 添加重定向 URI: http://localhost:3000/oauth2callback

2. 获取刷新令牌

OAUTH_CLIENT_ID="your_client_id" OAUTH_CLIENT_SECRET="your_client_secret" node get-refresh-token.js

3. 配置 MCP 设置

添加到您的 Claude 配置文件 (claude_desktop_config.jsoncline_mcp_settings.json):

{
  "mcpServers": {
    "youtube-watchlater": {
      "command": "node",
      "args": ["/path/to/youtube-watchlater/build/index.js"],
      "env": {
        "OAUTH_CLIENT_ID": "your_client_id",
        "OAUTH_CLIENT_SECRET": "your_client_secret",
        "OAUTH_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

使用方法

服务器提供 get_watch_later_urls 工具,接受 daysBack 参数:

// 获取最近一天添加的视频
{ "daysBack": 1 }

// 获取最近一周添加的视频
{ "daysBack": 7 }

返回结果示例:

[
  "https://youtube.com/watch?v=video1",
  "https://youtube.com/watch?v=video2",
  ...
]

刷新令牌通常不会过期,除非您明确撤销访问权限。需要时重新运行 get-refresh-token.js 获取新令牌。

功能特点

  • 检索指定时间段内添加的视频链接
  • 简单接口,仅返回视频 URL
  • 通过 OAuth2 安全访问您的 YouTube 数据