YouTube Watch Later MCP Server

YouTube Watch Later MCP 服务

一种 Model Context Protocol（MCP）服务，可访问自定义 YouTube 播放列表。该服务提供一个简单的工具，用于获取在指定时间范围内添加到指定播放列表的视频 URL。

功能

• 获取在可配置天数内添加到自定义播放列表的视频 URL
• 简单的接口，只返回视频 URL
• 通过 OAuth2 进行身份验证，安全访问你的 YouTube 数据

安装

通过 Smithery 安装

若要通过 Smithery 自动为 Claude Desktop 安装 YouTube Watch Later：

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

手动安装

1. 克隆此仓库：

git clone https://github.com/rados10/youtube-watchlater-mcp.git
cd youtube-watchlater

2. 安装依赖：

npm install

3. 构建项目：

npm run build

设置

1. 创建 Google Cloud 项目

1. 前往 Google Cloud Console
2. 创建新项目或选择现有项目
3. 启用 YouTube Data API v3
4. 前往 Credentials → Create Credentials → OAuth 2.0 Client ID
5. 将 Application Type 设为 "Web application"
6. 将 "http://localhost:3000/oauth2callback" 添加到 Authorized redirect URIs
7. 复制你的 Client ID 和 Client Secret

2. 获取刷新令牌

使用你的 Google Cloud 凭据运行提供的脚本：

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

脚本将：

• 在默认浏览器中打开 Google 授权页面
• 要求你登录并授权应用
• 在终端中显示你的刷新令牌

3. 配置 MCP 设置

将服务配置添加到你的 MCP 设置文件中：

对于 VSCode（Claude Dev Extension）： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

对于 Claude Desktop App： ~/Library/Application Support/Claude/claude_desktop_config.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 参数：

// Get videos added in the last day (default)
{ "daysBack": 1 }

// Get videos added in the last week
{ "daysBack": 7 }

该服务将返回符合条件的视频 YouTube URL 数组：

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

刷新令牌

除非你明确撤销访问权限，否则刷新令牌不会过期。仅在以下情况下需要获取新令牌：

• 在 Google 帐户设置中撤销应用的访问权限
• 重置 Google 帐户的安全设置
• 令牌因其他原因失效

如需获取新的刷新令牌，只需按照“设置”部分中的说明，再次运行 get-refresh-token.js 脚本。

开发

该服务使用以下技术构建：

• TypeScript
• @modelcontextprotocol/sdk
• googleapis（YouTube Data API v3）

修改服务：

1. 在 src/index.ts 中进行更改
2. 运行 npm run build 进行编译
3. 重启 MCP 服务以应用更改