YouTube MCP Server

YouTube MCP サーバー

Claude Desktop または MCP 互換クライアントを通じて YouTube に動画をアップロードできる MCP（Model Context Protocol）サーバーです。

機能

• 📹 動画のアップロード：カスタマイズ可能なメタデータを指定して、YouTube に動画ファイルをアップロードします
• 🔐 OAuth2 認証：YouTube API に安全に認証します
• 📊 クォータの確認：YouTube API の使用状況を監視します
• 📝 カテゴリの一覧表示：利用可能な動画カテゴリを確認します
• 🔧 簡単なセットアップ：認証情報の設定ツールが組み込まれています

前提条件

• Python 3.10 以降
• YouTube Data API v3 を有効にした Google Cloud プロジェクト
• Google Cloud Console で取得した OAuth2 認証情報
• Claude Desktop（または別の MCP クライアント）

セットアップ手順

1. 依存関係のインストール

# Clone or download this repository
cd youtube-mcp-server

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On macOS/Linux:
source venv/bin/activate
# On Windows:
# venv\Scripts\activate

# Install required packages
pip install -r requirements.txt

2. Google Cloud 認証情報の設定

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
3. YouTube Data API v3 を有効にします：
   • 「APIs & Services」>「Library」に移動します
   • 「YouTube Data API v3」を検索します
   • 「Enable」をクリックします
4. OAuth2 認証情報を作成します：
   • 「APIs & Services」>「Credentials」に移動します
   • 「Create Credentials」>「OAuth client ID」をクリックします
   • アプリケーションの種類として「Desktop app」を選択します
   • 認証情報の JSON ファイルをダウンロードします

3. Claude Desktop の設定

Claude Desktop の設定にサーバーを追加します：

macOS/Linux：

# Open config file
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows：

code $env:AppData\Claude\claude_desktop_config.json

次の設定を追加します：

{
    "mcpServers": {
        "youtube-uploader": {
            "command": "python",
            "args": [
                "/ABSOLUTE/PATH/TO/youtube-mcp-server/youtube_uploader.py"
            ]
        }
    }
}

4. 初回認証

1. Claude Desktop を再起動します
2. OAuth2 認証情報を使用して setup_youtube_auth ツールを実行します：
   • ダウンロードした JSON ファイルから client_id、client_secret、project_id を指定します
3. 動画のアップロードを試します。認証用のブラウザーウィンドウが開きます
4. YouTube アカウントへのアクセスを許可します

利用可能なツール

1. upload_video

YouTube に動画ファイルをアップロードします。

パラメーター：

• file_path（必須）：動画ファイルのパス
• title（必須）：動画のタイトル
• description：動画の説明
• keywords：カンマ区切りのタグ
• category_id：YouTube のカテゴリ ID（デフォルト：22）
• privacy_status：「private」、「unlisted」、または「public」（デフォルト：private）
• made_for_kids：COPPA 準拠を示すブール値

例：

Upload the video at /Users/me/video.mp4 with title "My Amazing Video" and description "This is a test upload"

2. check_upload_quota

YouTube API のクォータ使用状況とチャンネル情報を確認します。

3. list_video_categories

指定した地域で利用可能な YouTube 動画カテゴリを一覧表示します。

パラメーター：

• region_code：ISO 国コード（デフォルト：US）

4. setup_youtube_auth

YouTube API にアクセスするための OAuth2 認証情報を設定します。

重要な注意事項

• クォータ制限：YouTube API には日次クォータがあります。アップロード 1 回につき、1 日あたり 1,600,000 ユニットのうち約 1,600 ユニットを消費します。
• ファイルサイズ：大きなファイルはアップロードに時間がかかる場合があります。サーバーは再開可能なアップロードを使用します。
• プライバシー：安全のため、動画はデフォルトで「private」としてアップロードされます。
• 認証：OAuth2 トークンはローカルの token.json に保存されます。

トラブルシューティング

1. 「Missing credentials.json」：最初に setup_youtube_auth を実行してください
2. 認証エラー：token.json を削除して、再認証してください
3. アップロードの失敗：ファイルのパス、サイズ、形式を確認してください
4. クォータ超過：クォータがリセットされるまで 24 時間お待ちください

セキュリティ

• credentials.json ファイルと token.json ファイルは安全に保管してください
• これらのファイルをバージョン管理にコミットしないでください
• OAuth2 トークンには有効期限があります。サーバーが自動的に更新します

ライセンス

MIT ライセンス