YouTube Toolbox
py-mcp-youtube-ツールボックス
動画検索、トランスクリプト抽出、コメント取得など、YouTube を操作するための強力なツールを AI アシスタントに提供する MCP サーバー。
概要
py-mcp-youtube-toolbox は、次の YouTube 関連の機能を提供します。
高度なフィルタリングオプションでYouTube動画を検索
動画やチャンネルの詳細情報を取得する
並べ替えオプションを使用して動画コメントを取得する
複数の言語でビデオのトランスクリプトとキャプションを抽出します
特定の動画に関連する動画を検索する
地域別にトレンド動画をチェック
トランスクリプトに基づいてビデオコンテンツの要約を生成する
フィルタリング、検索、マルチビデオ機能を備えた高度なトランスクリプト分析
Related MCP server: YouTube MCP Server
目次
前提条件
Python : Python 3.12以降をインストールします
YouTube APIキー:
新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
YouTube Data API v3 を有効にします。
「APIとサービス」>「ライブラリ」に移動します
「YouTube Data API v3」を検索して有効にします
資格情報を作成します:
「APIとサービス」>「認証情報」に移動します
「認証情報を作成」>「APIキー」をクリックします
APIキーを書き留めてください
インストール
Gitクローン
git clone https://github.com/jikime/py-mcp-youtube-toolbox.git
cd py-mcp-youtube-toolbox構成
UV パッケージ マネージャーをインストールします。
curl -LsSf https://astral.sh/uv/install.sh | sh仮想環境を作成してアクティブ化します。
uv venv -p 3.12
source .venv/bin/activate # On MacOS/Linux
# or
.venv\Scripts\activate # On Windows依存関係をインストールします:
uv pip install -r requirements.txt環境変数:
cp env.example .env
vi .env
# Update with your YouTube API key
YOUTUBE_API_KEY=your_youtube_api_keyDockerの使用
Docker イメージをビルドします。
docker build -t py-mcp-youtube-toolbox .コンテナを実行します。
docker run -e YOUTUBE_API_KEY=your_youtube_api_key py-mcp-youtube-toolboxローカルの使用
サーバーを実行します。
mcp run server.pyMCP インスペクターを実行します。
mcp dev server.pyMCP設定を構成する
MCP 設定ファイルにサーバー構成を追加します。
クロードデスクトップアプリ
Smithery経由で自動的にインストールするには:
npx -y @smithery/cli install @jikime/py-mcp-youtube-toolbox --client claude手動でインストールするには
~/Library/Application Support/Claude/claude_desktop_config.jsonを開きます。
これをmcpServersオブジェクトに追加します。
{
"mcpServers": {
"YouTube Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-youtube-toolbox",
"run",
"server.py"
],
"env": {
"YOUTUBE_API_KEY": "your_youtube_api_key"
}
}
}
}カーソルIDE
~/.cursor/mcp.jsonを開く
これをmcpServersオブジェクトに追加します。
{
"mcpServers": {
"YouTube Toolbox": {
"command": "/path/to/bin/uv",
"args": [
"--directory",
"/path/to/py-mcp-youtube-toolbox",
"run",
"server.py"
],
"env": {
"YOUTUBE_API_KEY": "your_youtube_api_key"
}
}
}
}Docker用
{
"mcpServers": {
"YouTube Toolbox": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e", "YOUTUBE_API_KEY=your_youtube_api_key",
"py-mcp-youtube-toolbox"
]
}
}
}ツールドキュメント
ビデオツール
search_videos: 高度なフィルタリング オプション (チャンネル、再生時間、地域など) を使用して YouTube 動画を検索します。get_video_details: 特定の YouTube 動画の詳細情報 (タイトル、チャンネル、視聴回数、高評価など) を取得します。get_video_comments: 並べ替えオプションを使用して YouTube 動画からコメントを取得しますget_related_videos: 特定の YouTube 動画に関連する動画を検索するget_trending_videos: YouTube で地域別にトレンドの動画を取得する
チャンネルツール
get_channel_details: YouTube チャンネルの詳細情報 (名前、登録者数、視聴回数など) を取得します。
トランスクリプトツール
get_video_transcript: 指定された言語の YouTube 動画からトランスクリプト/キャプションを抽出しますget_video_enhanced_transcript: フィルタリング、検索、マルチビデオ機能を備えた高度なトランスクリプト抽出
プロンプトツール
transcript_summary: カスタマイズ可能なオプションを使用して、トランスクリプトに基づいて YouTube 動画コンテンツの要約を生成します。
リソースツール
youtube://available-youtube-tools: 利用可能なすべてのYouTubeツールのリストを取得しますyoutube://video/{video_id}: 特定の動画の詳細情報を取得しますyoutube://channel/{channel_id}: 特定のチャンネルに関する情報を取得しますyoutube://transcript/{video_id}?language={language}: 特定の動画のトランスクリプトを取得します
発達
ローカルテストの場合は、付属のクライアント スクリプトを使用できます。
# Example: Search videos
uv run client.py search_videos query="MCP" max_results=5
# Example: Get video details
uv run client.py get_video_details video_id=zRgAEIoZEVQ
# Example: Get channel details
uv run client.py get_channel_details channel_id=UCRpOIr-NJpK9S483ge20Pgw
# Example: Get video comments
uv run client.py get_video_comments video_id=zRgAEIoZEVQ max_results=10 order=time
# Example: Get video transcript
uv run client.py get_video_transcript video_id=zRgAEIoZEVQ language=ko
# Example: Get related videos
uv run client.py get_related_videos video_id=zRgAEIoZEVQ max_results=5
# Example: Get trending videos
uv run client.py get_trending_videos region_code=ko max_results=10
# Example: Advanced transcript extraction
uv run client.py get_video_enhanced_transcript video_ids=zRgAEIoZEVQ language=ko format=timestamped include_metadata=true start_time=100 end_time=200 query=에이전트 case_sensitive=true segment_method=equal segment_count=2
# Example: ライセンス
MITライセンス
Available Tools
8 toolsget_channel_detailsB
Get detailed information about a YouTube channel
Inputs: channel_id (required). Returns: result
get_trending_videosB
Get trending videos on YouTube by region
Inputs: region_code, max_results. Returns: result
get_video_commentsC
Get comments for a YouTube video
Inputs: video_id (required), max_results, order, include_replies, +1 more. Returns: result
get_video_detailsB
Get detailed information about a YouTube video
Inputs: video_id (required). Returns: result
get_video_enhanced_transcriptC
Advanced transcript extraction tool with filtering, search, and multi-video capabilities. Provides rich transcript data for detailed analysis and processing. Features: 1) Extract transcripts from multiple videos; 2) Filter by time ranges; 3) Search within transcripts; 4) Segment transcripts; 5) Format output in different ways; 6) Include video metadata.
Inputs: video_ids (required), language, start_time, end_time, +6 more. Returns: result
get_video_transcriptB
Get transcript/captions for a YouTube video
Inputs: video_id (required), language. Returns: result
search_videosC
Search for YouTube videos with advanced filtering options
Inputs: query (required), max_results, channel_id, order, +6 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools have distinct purposes, but there is notable overlap between get_video_transcript and get_video_enhanced_transcript, which could cause confusion as both handle transcripts with the enhanced version being a superset. Other tools like get_video_details and get_channel_details are clearly differentiated, but the transcript duplication weakens clarity.
All tool names follow a consistent snake_case pattern with a verb-noun structure (e.g., get_channel_details, search_videos). The naming is predictable and uniform across all eight tools, making it easy for agents to understand and use them without confusion.
With 8 tools, the count is well within the typical 3-15 range for a focused domain like YouTube data retrieval. It feels slightly thin for comprehensive coverage but reasonable for core functionalities such as fetching videos, channels, comments, and transcripts.
The toolset covers key read operations like getting details, searching, and fetching comments/transcripts, but lacks obvious write or management capabilities (e.g., upload, update, delete) that might be expected in a full YouTube toolbox. This creates notable gaps for agents needing to perform more than retrieval tasks.
Maintenance
Related MCP Connectors
An MCP server that integrates with Discord to provide AI-powered features.
An MCP server that gives any LLM or agent clean YouTube transcripts on demand: a single video, a whole channel, or a playlist, plus AI cleanup of auto-generated captions. API-key auth, credit-based, same backend as the public v1 API. Get a free API key with 25 free credits at youtubetranscriptdownload.com/account.
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Fetch YouTube transcripts, monitor channels and track keyword matches from your AI assistant.
Related MCP Servers
- AlicenseAqualityCmaintenanceAn MCP server for intelligent YouTube video analysis that provides token-optimized summaries, sentiment analysis, and entity extraction from transcripts. It enables AI assistants to perform video reporting, channel monitoring, and comprehensive YouTube searches through structured data tools.1053Apache 2.0
- AlicenseAqualityBmaintenanceMCP server that provides YouTube video data to AI agents, supporting search, metadata, comments, and transcripts without an API key.681 npmISC
- AlicenseAqualityDmaintenanceMCP server that lets AI agents search YouTube and fetch transcripts.23MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for YouTube that provides tools to fetch video metadata and transcripts, enabling natural language queries about YouTube videos.2-