YouTube Watch Later MCP 服务器

一个模型上下文协议 (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. 转到凭据 → 创建凭据 → OAuth 2.0 客户端 ID
5. 将应用程序类型设置为“Web 应用程序”
6. 将“http://localhost:3000/oauth2callback”添加到授权重定向 URI
7. 复制您的客户端 ID 和客户端密钥

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 参数：

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

// 获取最近一周添加的视频
{ "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 服务器以应用更改