YouTube Watch Later MCP Server

这是一个 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.json 或 cline_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 数据