YouTube Toolbox
py-mcp-youtube-toolbox
Ein MCP-Server, der KI-Assistenten leistungsstarke Tools zur Interaktion mit YouTube bereitstellt, darunter Videosuche, Transkriptextraktion, Kommentarabruf und mehr.
Überblick
py-mcp-youtube-toolbox bietet die folgenden YouTube-bezogenen Funktionen:
Durchsuchen Sie YouTube-Videos mit erweiterten Filteroptionen
Erhalten Sie detaillierte Informationen zu Videos und Kanälen
Videokommentare mit Sortieroptionen abrufen
Extrahieren Sie Videotranskripte und Untertitel in mehreren Sprachen
Ähnliche Videos zu einem bestimmten Video finden
Holen Sie sich Trendvideos nach Region
Erstellen Sie Zusammenfassungen von Videoinhalten basierend auf Transkripten
Erweiterte Transkriptanalyse mit Filter-, Such- und Multi-Video-Funktionen
Related MCP server: YouTube MCP Server
Inhaltsverzeichnis
Voraussetzungen
Python : Installieren Sie Python 3.12 oder höher
YouTube-API-Schlüssel :
Gehen Sie zur Google Cloud Console
Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes aus
Aktivieren Sie die YouTube Data API v3:
Gehen Sie zu „APIs & Dienste“ > „Bibliothek“
Suchen und aktivieren Sie „YouTube Data API v3“.
Anmeldeinformationen erstellen:
Gehen Sie zu „APIs & Dienste“ > „Anmeldeinformationen“
Klicken Sie auf „Anmeldeinformationen erstellen“ > „API-Schlüssel“.
Notieren Sie Ihren API-Schlüssel
Installation
Git-Klon
git clone https://github.com/jikime/py-mcp-youtube-toolbox.git
cd py-mcp-youtube-toolboxKonfiguration
Installieren Sie den UV-Paketmanager:
curl -LsSf https://astral.sh/uv/install.sh | shVirtuelle Umgebung erstellen und aktivieren:
uv venv -p 3.12
source .venv/bin/activate # On MacOS/Linux
# or
.venv\Scripts\activate # On WindowsInstallieren Sie Abhängigkeiten:
uv pip install -r requirements.txtUmgebungsvariablen:
cp env.example .env
vi .env
# Update with your YouTube API key
YOUTUBE_API_KEY=your_youtube_api_keyVerwenden von Docker
Erstellen Sie das Docker-Image:
docker build -t py-mcp-youtube-toolbox .Führen Sie den Container aus:
docker run -e YOUTUBE_API_KEY=your_youtube_api_key py-mcp-youtube-toolboxLokale Verwendung
Führen Sie den Server aus:
mcp run server.pyFühren Sie den MCP Inspector aus:
mcp dev server.pyMCP-Einstellungen konfigurieren
Fügen Sie die Serverkonfiguration zu Ihrer MCP-Einstellungsdatei hinzu:
Claude Desktop-App
So installieren Sie es automatisch über Smithery :
npx -y @smithery/cli install @jikime/py-mcp-youtube-toolbox --client claudeZur manuellen Installation öffnen Sie
~/Library/Application Support/Claude/claude_desktop_config.json
Fügen Sie dies zum mcpServers -Objekt hinzu:
{
"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"
}
}
}
}Cursor-IDE
Öffnen Sie ~/.cursor/mcp.json
Fügen Sie dies zum mcpServers -Objekt hinzu:
{
"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"
}
}
}
}für Docker
{
"mcpServers": {
"YouTube Toolbox": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e", "YOUTUBE_API_KEY=your_youtube_api_key",
"py-mcp-youtube-toolbox"
]
}
}
}Tools-Dokumentation
Video-Tools
search_videos: Suche nach YouTube-Videos mit erweiterten Filteroptionen (Kanal, Dauer, Region usw.)get_video_details: Erhalten Sie detaillierte Informationen zu einem bestimmten YouTube-Video (Titel, Kanal, Aufrufe, Likes usw.).get_video_comments: Ruft Kommentare aus einem YouTube-Video mit Sortieroptionen abget_related_videos: Finde Videos, die mit einem bestimmten YouTube-Video in Zusammenhang stehenget_trending_videos: Holen Sie sich Trendvideos auf YouTube nach Region
Kanal-Tools
get_channel_details: Erhalten Sie detaillierte Informationen zu einem YouTube-Kanal (Name, Abonnenten, Aufrufe usw.).
Transkriptionstools
get_video_transcript: Extrahieren Sie Transkripte/Untertitel aus YouTube-Videos in angegebenen Sprachenget_video_enhanced_transcript: Erweiterte Transkriptextraktion mit Filter-, Such- und Multivideofunktionen
Eingabeaufforderungstools
transcript_summary: Erstellen Sie Zusammenfassungen von YouTube-Videoinhalten basierend auf Transkripten mit anpassbaren Optionen
Ressourcentools
youtube://available-youtube-tools: Holen Sie sich eine Liste aller verfügbaren YouTube-Toolsyoutube://video/{video_id}: Erhalten Sie detaillierte Informationen zu einem bestimmten Videoyoutube://channel/{channel_id}: Informationen zu einem bestimmten Kanal abrufenyoutube://transcript/{video_id}?language={language}: Transkript für ein bestimmtes Video abrufen
Entwicklung
Für lokale Tests können Sie das enthaltene Client-Skript verwenden:
# 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: Lizenz
MIT-Lizenz
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-