mcpField
Y
YouTube MCP

YouTube MCP

ローカル
github.comソーシャルメディア614 週間前に更新

YouTube MCP について

YouTube MCPは、YouTubeのコンテンツやアカウント情報を扱うAIアシスタントやMCPクライアント向けのサーバーです。認証情報なしの字幕抽出に加え、APIキーでの公開データ取得とOAuthでの個人向け情報取得に対応します。

主な機能

  1. 01動画の字幕抽出
  2. 02動画、チャンネル、再生リストの検索
  3. 03動画とチャンネルのメタデータ取得
  4. 04コメント、字幕トラック、トレンド動画の確認
  5. 05OAuthによる登録チャンネルとメンバー情報の取得

活用シーン

  1. 01日付、長さ、地域を指定した動画検索
  2. 02動画の字幕とエンゲージメント統計の確認
  3. 03チャンネルのアクティビティと再生リストの調査
  4. 04個人の登録チャンネルやメンバーシップの確認

MCP 対応

MCP サーバーとして、YouTubeの検索、字幕、メタデータ、アカウント操作用ツールをMCPクライアントに提供します。公開データにはAPIキー、登録情報やメンバー情報にはOAuthが必要で、字幕抽出には認証情報は不要です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"mrsknetwork-ytmcp": {
"command": "npx",
"args": [
"-y",
"@mrsknetwork/ytmcp"
]
}
}
}
起動コマンドnpx -y @mrsknetwork/ytmcp

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@mrsknetwork/ytmcp1.0.14

ツール

19

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
orderenumいいえ結果の並べ替え順。'date' は新しい順、'viewCount' は再生回数順、'rating' は評価順です。relevance | date | rating | viewCount | title | videoCount
page_tokenstringいいえ次の結果ページを取得するための、前回の応答に含まれるトークン。
max_resultsnumberいいえデフォルトは 5。最大は 50。
region_codestringいいえ検索結果を地域で制限するための ISO 3166-1 alpha-2 国コード(例:'US'、'GB'、'IN')。
content_typestringいいえカンマ区切りのリスト(例:'video,channel,playlist')
search_querystringはい検索クエリ
video_durationenumいいえ動画の長さで絞り込みます。短い(<4 min)、中程度(4-20 min)、長い(>20 min)。content_type に 'video' が含まれる場合のみ適用されます。short | medium | long
published_afterstringいいえRFC 3339 の日時(例:'2024-01-01T00:00:00Z')。この日時より後に公開された結果のみを返します。
published_beforestringいいえRFC 3339 の日時(例:'2024-12-31T23:59:59Z')。この日時より前に公開された結果のみを返します。
video_definitionenumいいえ動画の画質で絞り込みます。'hd' または 'standard'。content_type に 'video' が含まれる場合のみ適用されます。hd | standard

詳細

YouTube MCP

AI アシスタントを YouTube に接続:検索、文字起こし、メタデータなど。

npm Downloads Socket Badge MIT MCP


何ができますか?

接続すると、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 キーを取得する

  1. Google Cloud Console を開きます。
  2. プロジェクトで YouTube Data API v3 を有効にします。
  3. 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 クライアントを作成する

  1. Google Cloud Console を開きます。
  2. プロジェクトで YouTube Data API v3 を有効にします。
  3. Credentials > Create Credentials > OAuth 2.0 Client ID に移動します。
  4. アプリケーションの種類を Web application に設定します。
  5. 次のリダイレクト URI を正確に追加します:http://localhost:31415/oauth2callback。
  6. 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_contentAPI KeyYouTube で動画、チャンネル、再生リストを検索します。order、published_after、published_before、video_duration、video_definition、region_code で絞り込めます。ページネーションに対応しています。
get_video_metadataAPI KeyID を指定して、1 件以上の動画のタイトル、説明、タグ、再生時間、統計情報(再生回数、高評価数、コメント数)を取得します。
get_channel_metadataAPI Keyチャンネルのプロフィール、登録者数、動画数、アップロード用再生リスト ID を取得します。チャンネル ID または @handle を指定できます。
list_trending_videosAPI Key指定した region_code と任意の category_id に基づいて、YouTube で最も人気のある動画を取得します。ページネーションに対応しています。
list_playlistsAPI Keyチャンネルの再生リストを一覧表示するか、ID を指定して特定の再生リストを取得します。タイトル、説明、アイテム数を返します。
list_playlist_itemsAPI Key再生リスト内のすべての動画を順番に一覧表示します。各項目のタイトル、位置、動画 ID を返します。
list_video_commentsAPI Key動画またはチャンネルのトップレベルのコメントスレッドを取得します。search_terms でキーワードによる絞り込みができます。ページネーションに対応しています。
list_comment_repliesAPI Keyparent_comment_id で指定したコメントスレッドへの返信を取得します。ページネーションに対応しています。
list_video_captionsAPI Key言語コードや種類(手動または自動生成)など、動画で利用可能な字幕トラックを一覧表示します。
list_video_categoriesAPI Key指定した地域の YouTube 動画カテゴリ名と ID を一覧表示します。ID は search_content または list_trending_videos で使用できます。
list_channel_activitiesAPI Keyアップロードや再生リストへの追加を含む、チャンネルの最近のアクティビティフィードを取得します。
list_channel_sectionsAPI Keyチャンネルページに表示されるセクションを順番に一覧表示します。
list_supported_languagesAPI KeyYouTube がサポートするすべての言語と、その言語コードおよびローカライズされた名称を一覧表示します。
list_supported_regionsAPI KeyYouTube がサポートするすべての地域と、その地域コードおよび名称を一覧表示します。
list_subscriptionsAPI Key / OAuthchannel_id(API Key)を指定してチャンネルの公開登録チャンネルを一覧表示するか、mine=true(OAuth)を指定して自身の登録チャンネルを一覧表示します。
list_channel_membersOAuthチャンネルの現在の有料メンバーを一覧表示します。有効なメンバーシッププログラムが必要です。
list_membership_levelsOAuthチャンネルに設定されているメンバーシップのティア名とレベルを一覧表示します。
revoke_oauth_tokenOAuthサインアウトし、サーバーに保存されている 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 に基づいてライセンスされています。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。