YouTube MCP について
YouTube MCPは、YouTubeのコンテンツやアカウント情報を扱うAIアシスタントやMCPクライアント向けのサーバーです。認証情報なしの字幕抽出に加え、APIキーでの公開データ取得とOAuthでの個人向け情報取得に対応します。
主な機能
- 01動画の字幕抽出
- 02動画、チャンネル、再生リストの検索
- 03動画とチャンネルのメタデータ取得
- 04コメント、字幕トラック、トレンド動画の確認
- 05OAuthによる登録チャンネルとメンバー情報の取得
活用シーン
- 01日付、長さ、地域を指定した動画検索
- 02動画の字幕とエンゲージメント統計の確認
- 03チャンネルのアクティビティと再生リストの調査
- 04個人の登録チャンネルやメンバーシップの確認
MCP 対応
MCP サーバーとして、YouTubeの検索、字幕、メタデータ、アカウント操作用ツールをMCPクライアントに提供します。公開データにはAPIキー、登録情報やメンバー情報にはOAuthが必要で、字幕抽出には認証情報は不要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
19掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| order | enum | いいえ | 結果の並べ替え順。'date' は新しい順、'viewCount' は再生回数順、'rating' は評価順です。relevance | date | rating | viewCount | title | videoCount |
| page_token | string | いいえ | 次の結果ページを取得するための、前回の応答に含まれるトークン。 |
| max_results | number | いいえ | デフォルトは 5。最大は 50。 |
| region_code | string | いいえ | 検索結果を地域で制限するための ISO 3166-1 alpha-2 国コード(例:'US'、'GB'、'IN')。 |
| content_type | string | いいえ | カンマ区切りのリスト(例:'video,channel,playlist') |
| search_query | string | はい | 検索クエリ |
| video_duration | enum | いいえ | 動画の長さで絞り込みます。短い(<4 min)、中程度(4-20 min)、長い(>20 min)。content_type に 'video' が含まれる場合のみ適用されます。short | medium | long |
| published_after | string | いいえ | RFC 3339 の日時(例:'2024-01-01T00:00:00Z')。この日時より後に公開された結果のみを返します。 |
| published_before | string | いいえ | RFC 3339 の日時(例:'2024-12-31T23:59:59Z')。この日時より前に公開された結果のみを返します。 |
| video_definition | enum | いいえ | 動画の画質で絞り込みます。'hd' または 'standard'。content_type に 'video' が含まれる場合のみ適用されます。hd | standard |
詳細
何ができますか?
接続すると、AI は次の操作を実行できます。
- 動画の正確な文字起こしを抽出します。認証情報は不要です。
- キーワード、期間、長さ、画質、地域を指定して YouTube を検索します。
- どの国やカテゴリでも、トレンド動画を取得します。
- 動画の統計情報、メタデータ、コメント、字幕、チャンネル情報を取得します。
@handle(例:@MrBeast)でチャンネルを検索します。- OAuth を使って、自分の登録チャンネル、メンバー、メンバーシップのティアにアクセスします。
はじめに
このサーバーには 3 つのアクセスレベルがあります。用途に合ったものを選んでください。
ゲストモード(設定不要)
すぐに使えます。get_video_transcript ツールは yt-dlp を使って、API 認証情報なしで文字起こしを抽出します。
{
"mcpServers": {
"youtube-mcp": {
"command": "npx",
"args": ["-y", "@mrsknetwork/ytmcp@latest"]
}
}
}
API キー(推奨)
すべての公開データツールを利用できます。検索、メタデータ、コメント、トレンド動画、文字起こしに最適です。
1. Google API キーを取得する
- Google Cloud Console を開きます。
- プロジェクトで YouTube Data API v3 を有効にします。
- Credentials に移動し、API Key を作成します。
2. MCP クライアントの設定または .env ファイルに追加する
MCP クライアントの設定で env を使って GOOGLE_API_KEY を渡すか、プロジェクトディレクトリ内の .env ファイルに GOOGLE_API_KEY=YOUR_KEY を記述します。
{
"mcpServers": {
"youtube-mcp": {
"command": "npx",
"args": ["-y", "@mrsknetwork/ytmcp@latest"],
"env": {
"GOOGLE_API_KEY": "YOUR_GOOGLE_API_KEY"
}
}
}
}
OAuth 2.0
非公開の登録チャンネル、メンバーシップ、アカウントのアクティビティに必要です。
1. OAuth 2.0 クライアントを作成する
- Google Cloud Console を開きます。
- プロジェクトで YouTube Data API v3 を有効にします。
- Credentials > Create Credentials > OAuth 2.0 Client ID に移動します。
- アプリケーションの種類を Web application に設定します。
- 次のリダイレクト URI を正確に追加します:
http://localhost:31415/oauth2callback。 - OAuth Consent Screen > Test Users に移動し、自分の Gmail アドレスを追加します。
2. MCP クライアントの設定に追加する
認証情報は MCP 設定内の環境変数を通じて安全に渡され、ファイルには保存されません。
{
"mcpServers": {
"youtube-mcp": {
"command": "npx",
"args": ["-y", "@mrsknetwork/ytmcp@latest"],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
"GOOGLE_CLIENT_SECRET": "your-client-secret"
}
}
}
}
3. 初回ログイン
最初のツール呼び出し時に、AI がログインリンクを共有します。リンクをクリックしてブラウザーでアプリを認証し、完了したことを AI に伝えてください。セッションは保存されます。アクセスを取り消さない限り、再度ログインする必要はありません。
4. サインアウト
サインアウトして、保存済みの認証情報をいつでも削除するには、AI に revoke_oauth_token を呼び出すよう依頼してください。
利用可能なツール
| ツール | 認証 | 説明 |
|---|---|---|
get_video_transcript | なし | yt-dlp を使用して、音声の全トランスクリプトをダウンロードします。language_code(例:en、es)と、手動字幕と自動生成字幕のどちらを優先するかを指定します。テキストとともにソースのメタデータを返します。 |
search_content | API Key | YouTube で動画、チャンネル、再生リストを検索します。order、published_after、published_before、video_duration、video_definition、region_code で絞り込めます。ページネーションに対応しています。 |
get_video_metadata | API Key | ID を指定して、1 件以上の動画のタイトル、説明、タグ、再生時間、統計情報(再生回数、高評価数、コメント数)を取得します。 |
get_channel_metadata | API Key | チャンネルのプロフィール、登録者数、動画数、アップロード用再生リスト ID を取得します。チャンネル ID または @handle を指定できます。 |
list_trending_videos | API Key | 指定した region_code と任意の category_id に基づいて、YouTube で最も人気のある動画を取得します。ページネーションに対応しています。 |
list_playlists | API Key | チャンネルの再生リストを一覧表示するか、ID を指定して特定の再生リストを取得します。タイトル、説明、アイテム数を返します。 |
list_playlist_items | API Key | 再生リスト内のすべての動画を順番に一覧表示します。各項目のタイトル、位置、動画 ID を返します。 |
list_video_comments | API Key | 動画またはチャンネルのトップレベルのコメントスレッドを取得します。search_terms でキーワードによる絞り込みができます。ページネーションに対応しています。 |
list_comment_replies | API Key | parent_comment_id で指定したコメントスレッドへの返信を取得します。ページネーションに対応しています。 |
list_video_captions | API Key | 言語コードや種類(手動または自動生成)など、動画で利用可能な字幕トラックを一覧表示します。 |
list_video_categories | API Key | 指定した地域の YouTube 動画カテゴリ名と ID を一覧表示します。ID は search_content または list_trending_videos で使用できます。 |
list_channel_activities | API Key | アップロードや再生リストへの追加を含む、チャンネルの最近のアクティビティフィードを取得します。 |
list_channel_sections | API Key | チャンネルページに表示されるセクションを順番に一覧表示します。 |
list_supported_languages | API Key | YouTube がサポートするすべての言語と、その言語コードおよびローカライズされた名称を一覧表示します。 |
list_supported_regions | API Key | YouTube がサポートするすべての地域と、その地域コードおよび名称を一覧表示します。 |
list_subscriptions | API Key / OAuth | channel_id(API Key)を指定してチャンネルの公開登録チャンネルを一覧表示するか、mine=true(OAuth)を指定して自身の登録チャンネルを一覧表示します。 |
list_channel_members | OAuth | チャンネルの現在の有料メンバーを一覧表示します。有効なメンバーシッププログラムが必要です。 |
list_membership_levels | OAuth | チャンネルに設定されているメンバーシップのティア名とレベルを一覧表示します。 |
revoke_oauth_token | OAuth | サインアウトし、サーバーに保存されている Google の認証情報を完全に削除します。 |
ソースからのビルド
サーバーをローカルで実行する手順。
git clone https://github.com/mrsknetwork/ytmcp.git
cd ytmcp
npm install
npm run build
cp .env.example .env # Set GOOGLE_API_KEY inside .env
node build/server/index.js
ライセンス
MIT License に基づいてライセンスされています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。