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

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:
  1. Gehen Sie zu „APIs & Dienste“ > „Bibliothek“
  2. Suchen und aktivieren Sie „YouTube Data API v3“.
- Anmeldeinformationen erstellen:
  1. Gehen Sie zu „APIs & Dienste“ > „Anmeldeinformationen“
  2. Klicken Sie auf „Anmeldeinformationen erstellen“ > „API-Schlüssel“.
  3. 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:

mcp run server.py

Führen Sie den MCP Inspector aus:

mcp dev server.py

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"
      ]
    }
  }
}

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 ab
get_related_videos : Finde Videos, die mit einem bestimmten YouTube-Video in Zusammenhang stehen
get_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 Sprachen
get_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-Tools
youtube://video/{video_id} : Erhalten Sie detaillierte Informationen zu einem bestimmten Video
youtube://channel/{channel_id} : Informationen zu einem bestimmten Kanal abrufen
youtube://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