Youtube Uploader Mcp

YouTube Uploader MCP

AI を活用した YouTube アップローダーです。コマンドラインも YouTube Studio も不要で、シークレットが LLM やサードパーティ製アプリと共有されることもなく、しかもすべて無料です！OAuth2 認証、トークン管理、動画アップロード機能を備えています。

機能

• 直接アップロード: Claude、Cursor、VS Code、その他の MCP クライアントから YouTube に動画をアップロードできます。
• AI 支援によるメタデータ: MCP クライアントを通じて、タイトル、説明、タグを自動生成します。
• OAuth2 認証: 安全なローカルログイン、複数チャンネルのサポート、自動更新に対応しています。
• メタデータと設定: カテゴリタグ、任意の言語設定、メタデータの明示的な制御に対応しています。
• 公開範囲とスケジュール: 公開、非公開、限定公開のステータス、および公開日時の予約に対応しています。
• アップロード後の設定（update_video）: 動画の再生リストへの追加、カスタムサムネイル（2MB 未満）のアップロード、字幕の添付、アップロード済み動画の公開日時の予約、子ども向け設定の更新が可能です。

ワンコマンドインストール

Mac および Linux の場合

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/anwerj/youtube-uploader-mcp/master/scripts/install.sh)"

Windows（Powershell）の場合

Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/anwerj/youtube-uploader-mcp/master/scripts/install.ps1" -OutFile "$env:TEMP\install.ps1"; PowerShell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\install.ps1"

期待される結果

この 1 つのコマンドで以下を実行します。

1. まだダウンロードされていない場合、oAuth クライアントシークレットファイルのダウンロードを支援します。
2. MCP サーバーをダウンロードします。
3. MCP サーバーを実行するために必要な最小限の権限を設定します。
4. Cluade Desktop の設定を youtube-uploader-mcp サーバーで自動更新します。
5. 最後に、その他のクライアント（VS Code／Cursor／AnythingLLM など）向けの正確な MCP 設定を出力します。

デモ

セットアップとデモ動画

手動インストール

ワンコマンドインストールを確認してください。手動インストールを希望する場合は、そのまま進めてください。

Releases ページにアクセスし、お使いのオペレーティングシステムに適したバイナリをダウンロードしてください。

• youtube-uploader-mcp-linux-amd64
• youtube-uploader-mcp-darwin-arm64
• youtube-uploader-mcp-windows-amd64.exe
• など

最新のバージョンタグ（例：v1.0.0）を使用できます。

---

2. 実行可能にする（Linux/macOS）

chmod +x path/to/youtube-uploader-mcp-<os>-<arch>

3. MCP を設定する（例：Claude Desktop または Cursor 内）

{
  "mcpServers": {
    "youtube-uploader-mcp": {
      "command": "/absolute/path/to/youtube-uploader-mcp-<os>-<arch>",
      "args": [
        "-client_secret_file",
        "/absolute/path/to/client_secret.json(See Below)"
      ]
    }
  }
}

4. Google OAuth 2.0 を設定する

YouTube にアップロードするには、OAuth を設定し、Google Developer Console から client_secret.json ファイルを取得する必要があります。

➡️ 手順を追った説明については、youtube_oauth2_setup.md のガイドに従ってください。

警告

重要：機密性の高い OAuth スコープと再認証： 字幕／キャプションのアップロードは https://www.googleapis.com/auth/youtube.force-ssl スコープに依存しており、これは YouTube Data API がキャプションの書き込み操作を実行するために必要です。

• 既存ユーザー: この MCP の古いバージョンで認証した場合、保存されたトークンにはこのスコープが含まれていません。字幕をアップロードしようとする呼び出しは、403 Forbidden API エラーで失敗します。
• 更新方法: チャンネルキャッシュファイル（通常は作業ディレクトリ内の .youtube_uploader_channels_cache）を削除し、authenticate ツールを再実行して新しい権限を付与する必要があります。
• Google Console の警告: この機密性の高いスコープを追加すると、Google Cloud Console で警告画面が表示されます。これは個人利用を目的としているため、「未確認のアプリ」という警告をそのまま進めても問題ありません。

使用方法とツールのオーケストレーション

MCP サーバーは以下のツールを登録します：

1. authenticate: 認証用の OAuth2 URL を生成します。
2. accesstoken: コードをユーザー資格情報およびチャンネル情報と交換します。
3. channels: 認証済みのチャンネルを取得します。
4. refreshtoken: トークンを強制的にリフレッシュします。
5. upload_video: 動画ファイルをアップロードし、主要な詳細（タイトル、説明、タグ、カテゴリ、任意の言語、ステータス、子ども向けフラグ、公開スケジュール）を設定します。
6. update_video: アップロード後の設定を管理する分離されたツールです：動画を再生リストに追加し、カスタムサムネイル（2MB 未満である必要があります）をアップロードし、字幕/キャプショントラックを添付し、既存の非公開動画を RFC3339 時刻に公開するようスケジュールし、子ども向け視聴者設定を更新します。
7. list_videos: チャンネルにアップロードされた動画（公開、限定公開、非公開）を一覧表示します。タイトル/説明の検索、プライバシーフィルター、日付順の並べ替えを任意で指定できます。

コントリビューション

コントリビューションについては CONTRIBUTING.md を参照してください。