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
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-toolbox
Konfiguration
- Installieren Sie den UV-Paketmanager:
curl -LsSf https://astral.sh/uv/install.sh | sh
- Virtuelle Umgebung erstellen und aktivieren:
uv venv -p 3.12
source .venv/bin/activate # On MacOS/Linux
# or
.venv\Scripts\activate # On Windows
- Installieren Sie Abhängigkeiten:
uv pip install -r requirements.txt
- Umgebungsvariablen:
cp env.example .env
vi .env
# Update with your YouTube API key
YOUTUBE_API_KEY=your_youtube_api_key
Verwenden 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-toolbox
Lokale Verwendung
- Führen Sie den Server aus:
- Führen Sie den MCP Inspector aus:
MCP-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 claude
- Zur 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"
]
}
}
}
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
get_channel_details : Erhalten Sie detaillierte Informationen zu einem YouTube-Kanal (Name, Abonnenten, Aufrufe usw.).
get_video_transcript : Extrahieren Sie Transkripte/Untertitel aus YouTube-Videos in angegebenen Sprachenget_video_enhanced_transcript : Erweiterte Transkriptextraktion mit Filter-, Such- und Multivideofunktionen
transcript_summary : Erstellen Sie Zusammenfassungen von YouTube-Videoinhalten basierend auf Transkripten mit anpassbaren Optionen
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