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 保護。