Youtube Ultimate Toolkit MCP

🚀 YouTube Ultimate Toolkit - MCP

強力なModel Context Protocol (MCP)サーバーで、Claude AIがYouTubeのコンテンツ（文字起こし、メタデータ、コメント、スクリーンショット、オーディオクリップ）に完全にアクセスできるようにします。

Claude Desktop（ローカル）とClaude Web UI（OAuthを使用したリモート）の両方で動作します。

🚀 クイックスタート

オプション1: ローカルモード (Claude Desktop)

# インストール
git clone https://github.com/Comzee/Youtube-Ultimate-Toolkit-MCP.git
cd Youtube-Ultimate-Toolkit-MCP
npm install
npm run build

# 実行
node dist/index.js

Claude Desktopの設定ファイル（Linuxでは~/.config/claude/claude_desktop_config.json、macOSでは~/Library/Application Support/Claude/claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "youtube": {
      "command": "node",
      "args": ["/path/to/Youtube-Ultimate-Toolkit-MCP/dist/index.js"]
    }
  }
}

オプション2: リモートモード (Claude Web UI)

リモートモードでは、OAuthの設定と公開URLが必要です。詳細は以下のリモートモードの設定を参照してください。

✨ 主な機能

📦 インストール

git clone https://github.com/Comzee/Youtube-Ultimate-Toolkit-MCP.git
cd Youtube-Ultimate-Toolkit-MCP
npm install
npm run build

💻 使用例

基礎的な使用法

以下のコマンドでローカルモードでのサーバーの起動例です。

# インストール
git clone https://github.com/Comzee/Youtube-Ultimate-Toolkit-MCP.git
cd Youtube-Ultimate-Toolkit-MCP
npm install
npm run build

# 実行
node dist/index.js

高度な使用法

リモートモードでのサーバーの起動と設定例です。

1. 環境の設定

cp .env.example .env

.envファイルを編集します。

# OAuthの認証情報
OAUTH_CLIENT_ID=youtube-mcp-client
OAUTH_CLIENT_SECRET=your-secret-here  # 生成方法: openssl rand -hex 32

# 同意画面のパスワード (bcryptハッシュ)
# 生成方法: node -e "require('bcrypt').hash('your-password', 12).then(console.log)"
AUTH_PASSWORD_HASH=$2b$12$...your-hash-here...

# オプション: get_commentsツール用のYouTube APIキー
YOUTUBE_API_KEY=your-api-key-here

2. サーバーの起動

# 開発環境
npm run start:remote

# 本番環境 (systemdを使用)
sudo cp youtube-mcp.service /etc/systemd/system/
# サービスファイルを編集して、ユーザー名とパスを設定します
sudo nano /etc/systemd/system/youtube-mcp.service
sudo systemctl daemon-reload
sudo systemctl enable youtube-mcp
sudo systemctl start youtube-mcp

3. HTTPSの設定 (必須)

Claude Web UIはHTTPSを必要とします。nginxをリバースプロキシとして使用します。

server {
    listen 443 ssl;
    server_name your-domain.com;

    ssl_certificate /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;

    location / {
        proxy_pass http://localhost:3010;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # WebSocketのサポート
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        # 長時間実行されるリクエストに重要
        proxy_buffering off;
        proxy_cache off;
        proxy_read_timeout 86400s;
        proxy_send_timeout 86400s;
        proxy_set_header X-Accel-Buffering no;
    }
}

4. Claude Web UIの接続

1. 設定 → コネクター → カスタムコネクターの追加に移動します。
2. URLを入力します: https://your-domain.com/mcp
3. 新しいチャットを開始し、MCPを有効にします。
4. ClaudeにYouTube動画を取得するように依頼すると、認証ポップアップが表示されます。
5. 同意画面でパスワードを入力し、「承認」をクリックします。

📚 ドキュメント

ツールリファレンス

get_video

動画のメタデータと英語の文字起こしを取得します。

パラメータ:

サポートされるURL形式:

• youtube.com/watch?v=VIDEO_ID
• youtu.be/VIDEO_ID
• youtube.com/shorts/VIDEO_ID
• youtube.com/live/VIDEO_ID
• youtube.com/embed/VIDEO_ID
• m.youtube.com/watch?v=VIDEO_ID
• music.youtube.com/watch?v=VIDEO_ID
• 直接の動画ID: dQw4w9WgXcQ

get_playlist

YouTubeのプレイリスト内の動画をリストします。

パラメータ:

get_comments

動画のトップコメントを取得します。 .envファイルにYOUTUBE_API_KEYが必要です。

パラメータ:

get_screenshot

動画からフレームをキャプチャします。 ffmpegが必要です。

パラメータ:

返り値: Base64エンコードされたJPEG画像

get_audio

分析用のオーディオクリップを抽出します。 ffmpegが必要です。

パラメータ:

返り値: Base64エンコードされたMP3オーディオ（128kbps）

OAuthとセキュリティ

リモートモードでは、OAuth 2.1とPKCEを実装して安全な認証を行います。

動作原理

1. Claudeが/mcpに接続します - 検出/ハンドシェイクメソッドは認証なしで動作します。
2. ツールを使用すると、ClaudeはOAuth検出情報を含む401エラーを受け取ります。
3. Claudeが動的クライアント登録を行います。
4. ブラウザが同意画面を開きます - パスワードを入力します。
5. Claudeが認証コードをアクセストークンに交換します。
6. その後のリクエストではBearerトークンを使用します。

セキュリティ機能

トラブルシューティング

"No English transcript available"

yt-dlpを更新してください - YouTubeは頻繁に変更されます。

pip3 install --upgrade yt-dlp

MCPがClaude Web UIから接続できない

• HTTPSが正しく設定されていることを確認してください。
• サービスの状態を確認します: sudo systemctl status youtube-mcp
• ログを確認します: sudo journalctl -u youtube-mcp -f

OAuthフローが開始されない

• .well-known/エンドポイントが200を返すことを確認してください（401ではなく）。
• ブラウザのコンソールでCORSエラーがないことを確認してください。
• /registerが有効な認証情報を返すことを確認してください。

認証ウィンドウが表示されない

• OAuthは最初のツールの使用時にトリガーされ、接続時にはトリガーされません。
• チャットを開始し、MCPを有効にしてから、ClaudeにYouTube動画を取得するように依頼してください。

Claudeが間違った/古いツールを使用している

Claudeの設定でMCPを切断して再接続し、ツールリストを更新してください。

Claudeプロジェクトのプロンプト

Claudeプロジェクトでこのプロンプトを使用すると、自動的にMCPを活用できます。

You have access to the YouTube MCP server. When I share a YouTube URL:
1. Automatically fetch the transcript with get_video
2. Provide a summary, key takeaways, and notable quotes
3. For long videos (10+ min), consider using keySegmentsOnly=true first

Available tools:
- get_video: Transcript and metadata (supports timestamps, time ranges, search)
- get_playlist: List videos in a playlist
- get_comments: Top comments (requires API key)
- get_screenshot: Capture frames at any timestamp
- get_audio: Extract audio clips for analysis (max 120s)

アーキテクチャ

• トランスポート: Streamable HTTP (MCP spec 2025-03-26)
• セッション: UUID識別子を使用したステートフル（メモリ内）
• OAuth: Authorization Code + PKCE, 動的クライアント登録
• トークン: メモリ内ストレージ（再起動時に失われます）

🔧 技術詳細

なぜこのMCPを選ぶべきか？

前提条件

• Node.js 18+
• yt-dlp - YouTubeコンテンツの取得ツール（常に最新版を維持する必要があります）
• ffmpeg - スクリーンショットとオーディオ抽出用（オプション）
• YouTube API Key - コメント機能のみに必要（オプション）

前提条件のインストール

Ubuntu/Debian:

# Node.js 18+
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

# yt-dlp (常に最新版を維持 - YouTubeは古いバージョンを頻繁に破壊します)
pip3 install --upgrade yt-dlp

# ffmpeg (スクリーンショットとオーディオ用)
sudo apt install ffmpeg

macOS:

brew install node yt-dlp ffmpeg

Windows:

# https://nodejs.org からNode.jsをインストール
# yt-dlpをインストール: pip install yt-dlp
# https://ffmpeg.org/download.html からffmpegをインストール

yt-dlpの更新

YouTubeは頻繁にAPIを変更します。文字起こしが機能しなくなった場合は、yt-dlpを更新してください。

pip3 install --upgrade yt-dlp
# または、外部管理パッケージについて警告を出すシステムでは:
pip3 install --upgrade --break-system-packages yt-dlp

📄 ライセンス

MIT - 詳細はLICENSEを参照してください。

コントリビュート

コントリビューションは大歓迎です！GitHubでイシューまたはプルリクエストを開いてください。