youtube-mcp
YouTube MCP Server
YouTube向けのModel Context Protocol(MCP)サーバー実装です。標準化されたインターフェースを通じて、AI言語モデルがYouTubeのコンテンツと対話できるようにします。
Webサイト: zubeidhendricks.github.io/youtube-mcp-server
利用可能なツール
このサーバーは現在、10個のMCPツールを公開しています。
ツール | 説明 | 必須パラメータ | オプションパラメータ |
| YouTube動画に関する詳細情報を取得します |
|
|
| YouTubeで動画を検索します |
|
|
| YouTube動画のトランスクリプトを取得します |
|
|
| YouTubeチャンネルに関する情報を取得します |
| なし |
| 複数のYouTubeチャンネルに関する情報を取得します |
|
|
| ハンドル、名前、またはクエリでYouTubeチャンネルを検索します |
|
|
| 動画での言及から、チャンネル規模とアクティビティのフィルタ付きでクリエイターチャンネルを検索します |
|
|
| 特定のチャンネルから動画を取得します |
|
|
| YouTubeプレイリストに関する情報を取得します |
| なし |
| YouTubeプレイリスト内の動画を取得します |
|
|
ツールパラメータ
videos_getVideo
videoId(string): YouTube動画ID。parts(string[], オプション): 取得する動画リソースの特定のパーツ。
videos_searchVideos
query(string): 検索クエリ。maxResults(number, オプション): 返す結果の最大数。order(string, オプション):relevanceやdateなどの結果の並び順。publishedAfter(string, オプション): このISO 8601日付以降に公開された動画のみを含めます。publishedBefore(string, オプション): このISO 8601日付より前に公開された動画のみを含めます。channelId(string, オプション): 結果を特定のチャンネルに制限します。uniqueChannels(boolean, オプション): 一意のチャンネルごとに1本の動画のみを返します。channelMinSubscribers/channelMaxSubscribers(number, オプション): 一致した動画を、そのチャンネルの登録者数帯でフィルタリングします。channelLastUploadAfter/channelLastUploadBefore(string, オプション): 一致した動画を、そのチャンネルの最新アップロードアクティビティでフィルタリングします。creatorOnly(boolean, オプション): 結果を、ヒューリスティックにクリエイターとして分類されたチャンネルに制限します。sortBy(string, オプション):relevance、subscribers_asc、subscribers_desc、indie_priority、recent_activityに対応しています。
transcripts_getTranscript
videoId(string): YouTube動画ID。language(string, オプション): トランスクリプトの言語コード。YOUTUBE_TRANSCRIPT_LANGまたはenにフォールバックします。
channels_getChannel
channelId(string): YouTubeチャンネルID。
レスポンスには以下のものが含まれます:
latestVideoPublishedAtnormalizedMetadataには
country、defaultLanguage、joinedAt、customUrl、emailsFound、contactLinks、およびクリエイター対ブランドのヒューリスティックフィールドが含まれます
channels_getChannels
channelIds(string[]): YouTubeチャンネルIDのリスト。includeLatestUpload(boolean, オプション):latestVideoPublishedAtを含めるかどうか。デフォルトはtrue。
channels_searchChannels
query(string): チャンネル検索クエリまたはハンドル。maxResults(number, オプション): 返すチャンネルの最大数。order(string, オプション):relevanceなどの結果の並び順。channelType(string, オプション): 検索を特定のチャンネルタイプに制限します。minSubscribers/maxSubscribers(number, オプション): 登録者数帯でチャンネルをフィルタリングします。lastUploadAfter/lastUploadBefore(string, オプション): 最新のアップロードアクティビティでチャンネルをフィルタリングします。creatorOnly(boolean, オプション): 結果を、ヒューリスティックにクリエイターとして分類されたチャンネルに制限します。sortBy(string, オプション):relevance、subscribers_asc、subscribers_desc、indie_priority、recent_activityに対応しています。
channels_findCreators
query(string): 一致した動画からチャンネルを発見するための、トピック、ゲーム、または言及クエリ。videoPublishedAfter/videoPublishedBefore(string, オプション): 一致した動画の新しさに関するフィルタ。channelMinSubscribers/channelMaxSubscribers(number, オプション): 返されるチャンネルの登録者数帯フィルタ。channelLastUploadAfter/channelLastUploadBefore(string, オプション): 返されるチャンネルの最新アップロードアクティビティフィルタ。creatorOnly(boolean, オプション): 結果を、ヒューリスティックにクリエイターとして分類されたチャンネルに制限します。sortBy(string, オプション):relevance、subscribers_asc、subscribers_desc、indie_priority、recent_activityに対応しています。sampleVideosPerChannel(number, オプション): 返されるチャンネルごとに含める一致した動画の数。
channels_listVideos
channelId(string): YouTubeチャンネルID。maxResults(number, オプション): 返す動画の最大数。
playlists_getPlaylist
playlistId(string): YouTubeプレイリストID。
playlists_getPlaylistItems
playlistId(string): YouTubeプレイリストID。maxResults(number, オプション): 返すプレイリスト項目の最大数。
Related MCP server: mcp-server-youtube
インストール
Claude Desktopのクイックセットアップ
パッケージをインストールします:
npm install -g zubeid-youtube-mcp-serverClaude Desktopの設定に追加します(macOSでは
~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは%APPDATA%\Claude\claude_desktop_config.json):
{
"mcpServers": {
"zubeid-youtube-mcp-server": {
"command": "zubeid-youtube-mcp-server",
"env": {
"YOUTUBE_API_KEY": "your_primary_youtube_api_key",
"YOUTUBE_API_KEY2": "your_secondary_youtube_api_key",
"YOUTUBE_API_KEY3": "your_tertiary_youtube_api_key"
}
}
}
}代替方法: NPXを使用する(インストール不要)
これをClaude Desktopの設定に追加します:
{
"mcpServers": {
"youtube": {
"command": "npx",
"args": ["-y", "zubeid-youtube-mcp-server"],
"env": {
"YOUTUBE_API_KEY": "your_primary_youtube_api_key",
"YOUTUBE_API_KEY2": "your_secondary_youtube_api_key",
"YOUTUBE_API_KEY3": "your_tertiary_youtube_api_key"
}
}
}
}Smitheryでのインストール
Claude Desktop用のYouTube MCP ServerをSmithery経由で自動的にインストールするには:
npx -y @smithery/cli install @ZubeidHendricks/youtube --client claude設定
次の環境変数を設定します:
YOUTUBE_API_KEY: プライマリYouTube Data APIキーYOUTUBE_API_KEY2: セカンダリのフォールバックAPIキーYOUTUBE_API_KEY3: 3番目のフォールバックAPIキーYOUTUBE_TRANSCRIPT_LANG: トランスクリプトのデフォルト言語(オプション、デフォルトは 'en')
YOUTUBE_API_KEY、YOUTUBE_API_KEY2、YOUTUBE_API_KEY3 のうち少なくとも1つを設定する必要があります。キーが割り当て枠(クォータ)を使い果たしたためにリクエストが失敗した場合、サーバーは設定された次のキーで同じリクエストを再試行します。
VS Codeでの使用
ワンクリックインストールを行うには、以下のインストールボタンのいずれかをクリックします:
手動インストール
手動インストールをご希望の場合は、まずこのセクションの上部にあるインストールボタンを確認してください。それ以外の場合は、次の手順に従ってください:
次のJSONブロックをVS Codeのユーザー設定(JSON)ファイルに追加します。これを行うには、Ctrl + Shift + P を押して Preferences: Open User Settings (JSON) と入力します。
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "apiKey",
"description": "YouTube API Key",
"password": true
}
],
"servers": {
"youtube": {
"command": "npx",
"args": ["-y", "zubeid-youtube-mcp-server"],
"env": {
"YOUTUBE_API_KEY": "${input:apiKey}"
}
}
}
}
}必要に応じて、ワークスペース内の .vscode/mcp.json というファイルに追加することもできます:
{
"inputs": [
{
"type": "promptString",
"id": "apiKey",
"description": "YouTube API Key",
"password": true
}
],
"servers": {
"youtube": {
"command": "npx",
"args": ["-y", "zubeid-youtube-mcp-server"],
"env": {
"YOUTUBE_API_KEY": "${input:apiKey}"
}
}
}
}開発
# Install dependencies
npm install
# Build
npm run build
# Start the server (requires at least one configured YouTube API key)
npm start
# Development mode with auto-rebuild
npm run devDocker
同梱のDockerイメージは、デフォルトでHTTP経由でサーバーを起動します。
デフォルトのトランスポート:
httpデフォルトのエンドポイント:
http://localhost:8088/mcpレディネスエンドポイント:
http://localhost:8088/readyデフォルトモード:ステートレス
Dockerビルドは .env をランタイムイメージにコピーし、サーバーは起動時に自動的にそれを読み込みます。つまり、docker build の時点で .env が存在していれば、docker run の時にAPI認証情報を渡さなくてもコンテナを実行できます。
docker build -t youtube-mcp-server .
docker run --rm -p 8088:8088 youtube-mcp-serverコンテナのデフォルトは次のとおりです:
MCP_TRANSPORT=http
MCP_HOST=0.0.0.0
MCP_PORT=8088
MCP_STATELESS=true貢献
このリポジトリへの貢献については、CONTRIBUTING.md を参照してください。
ライセンス
このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。
Available Tools
10 toolschannels_findCreatorsB
Find creator channels from video mentions with subscriber band and recent activity filters in one call
Inputs: query (required), order, sortBy, maxResults, +8 more.
channels_getChannelC
Get information about a YouTube channel
Inputs: channelId (required).
channels_getChannelsC
Get information about multiple YouTube channels
Inputs: channelIds (required), parts, includeLatestUpload.
channels_listVideosC
Get videos from a specific channel
Inputs: channelId (required), maxResults.
channels_searchChannelsC
Search for YouTube channels by handle, name, or query
Inputs: query (required), order, sortBy, maxResults, +6 more.
playlists_getPlaylistC
Get information about a YouTube playlist
Inputs: playlistId (required).
playlists_getPlaylistItemsB
Get videos in a YouTube playlist
Inputs: playlistId (required), maxResults.
transcripts_getTranscriptC
Get the transcript of a YouTube video
Inputs: videoId (required), language.
videos_getVideoB
Get detailed information about a YouTube video
Inputs: videoId (required), parts.
videos_searchVideosC
Search for videos on YouTube
Inputs: query (required), order, sortBy, channelId, +9 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Most tools have clearly distinct purposes: getVideo, searchVideos, getTranscript, getChannel, etc. However, channels_getChannels and channels_findCreators both retrieve multiple channels, which could cause confusion, though findCreators has specific filters. Overlap is limited and descriptions help differentiate.
All tool names follow a consistent pattern of resource_category + verb_noun (e.g., videos_getVideo, playlists_getPlaylistItems, channels_getChannel). The pattern is predictable and uniform across all tools.
With 10 tools, the set is well-scoped for YouTube interactions, covering core entities like videos, playlists, channels, and transcripts without excessive redundancy. Each tool appears to earn its place.
The surface covers key read operations for videos, playlists, channels, and transcripts. However, there is no tool for searching playlists or retrieving video comments, which could be considered gaps, but they are minor for most agent use cases.
Maintenance
Related MCP Connectors
Search YouTube videos, read transcripts and get public video information in your AI assistant.
YouTube transcripts, search, channel/playlist listings and upload tracking for AI agents.
Fetch YouTube transcripts, monitor channels and track keyword matches from your AI assistant.
YouTube search, whole channels, video stats, comments and full transcripts with timestamps.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants to access YouTube data in real-time, with capabilities for searching videos, analyzing channels, retrieving video details, and extracting transcripts.13MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search videos, read channels, browse playlists, fetch comments, and get transcripts from YouTube using the YouTube Data API v3 and InnerTube API for captions.2GPL 3.0
- FlicenseAqualityDmaintenanceEnables fetching YouTube video transcripts in various formats via the Model Context Protocol, allowing LLMs to access and process YouTube video transcripts securely.1-
- AlicenseAqualityDmaintenanceEnables AI tools to access YouTube content, including transcript extraction, video/channel info, and search.423 npmMIT