Youtube Watchlater MCP

🚀 YouTube 观看稍后再看 MCP 服务器

这是一个基于 Model Context Protocol (MCP) 的服务器，可提供对自定义 YouTube 播放列表的访问。它提供了一个简单工具，能获取指定时间段内添加到指定播放列表中的视频 URL。

🚀 快速开始

该服务器为你提供了便捷的方式来获取自定义 YouTube 播放列表中的视频 URL，下面将为你详细介绍其功能、安装、设置和使用方法。

✨ 主要特性

• 获取在指定天数内添加到自定义播放列表中的视频 URL。
• 提供简单接口，仅返回视频 URL。
• 使用 OAuth2 进行身份验证，确保对 YouTube 数据的安全访问。

📦 安装指南

通过 Smithery 安装

要自动通过 Smithery 安装 YouTube 观看稍后再看插件，可使用以下命令：

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 插件)： ~/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，接受一个可选的天数参数：

基础用法

# 获取最近一天添加的所有视频
get_watch_later_urls --days=1

# 获取过去七天添加的所有视频
get_watch_later_urls --days=7

# 获取过去30天添加的所有视频
get_watch_later_urls --days=30

返回结果

{
  "videos": [
    {
      "url": "https://www.youtube.com/watch?v=video123",
      "title": "视频标题 1",
      "duration": "3:45"
    },
    {
      "url": "https://www.youtube.com/watch?v=video456",
      "title": "视频标题 2",
      "duration": "5:20"
    }
  ]
}

开发

此工具使用以下技术栈：

• TypeScript：用于编写代码。
• Node.js：作为运行时环境。
• Oauth2：用于身份验证。
• Google API：用于与 YouTube 数据 API 进行交互。

修改服务器

1. 打开 src/index.ts 文件。
2. 根据需要修改代码。
3. 重新构建项目：

npm run build

提交更改

要提交更改到仓库，请执行以下步骤：

1. 添加更改：

git add .

2. 提交更改：

git commit -m "添加新功能"

3. 推送到 GitHub：

git push origin main

贡献

欢迎为这个项目做出贡献！请按照以下步骤进行：

1. 叉出仓库到您的账户。
2. 创建新的功能分支。
3. 提交更改并创建拉取请求。

📄 许可证

本项目受 MIT License 保护。