Youtube Watchlater MCP

🚀 YouTube 視聴予約MCPサーバー

このサーバーは、カスタムYouTube再生リストへのアクセスを提供するModel Context Protocol (MCP) サーバーです。指定された期間内に指定された再生リストに追加された動画のURLを取得するためのシンプルなツールを提供します。

🚀 クイックスタート

このサーバーを使用することで、指定した期間内にカスタムYouTube再生リストに追加された動画のURLを簡単に取得できます。OAuth2を用いた認証により、YouTubeデータへの安全なアクセスが保証されます。

✨ 主な機能

• 指定した日数以内にカスタム再生リストに追加された動画の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 というシンプルなツールを提供します。

# 直近1日以内に追加されたすべての動画を取得する
get_watch_later_urls --days=1

# 過去7日以内に追加されたすべての動画を取得する
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 の下で保護されています。