Skip to main content
Glama
YouTube Toolbox

YouTube Toolbox

by jikime

py-mcp-youtube-toolbox

Schmiedeabzeichen VersionLizenz

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

  1. Python : Installieren Sie Python 3.12 oder höher

  2. 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

  1. Installieren Sie den UV-Paketmanager:

curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Virtuelle Umgebung erstellen und aktivieren:

uv venv -p 3.12
source .venv/bin/activate  # On MacOS/Linux
# or
.venv\Scripts\activate  # On Windows
  1. Installieren Sie Abhängigkeiten:

uv pip install -r requirements.txt
  1. Umgebungsvariablen:

cp env.example .env
vi .env
# Update with your YouTube API key
YOUTUBE_API_KEY=your_youtube_api_key

Verwenden von Docker

  1. Erstellen Sie das Docker-Image:

docker build -t py-mcp-youtube-toolbox .
  1. Führen Sie den Container aus:

docker run -e YOUTUBE_API_KEY=your_youtube_api_key py-mcp-youtube-toolbox

Lokale Verwendung

  1. Führen Sie den Server aus:

mcp run server.py
  1. 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

  1. So installieren Sie es automatisch über Smithery :

npx -y @smithery/cli install @jikime/py-mcp-youtube-toolbox --client claude
  1. 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

Available Tools

8 tools
get_channel_detailsB

Get detailed information about a YouTube channel

Inputs: channel_id (required). 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

    B3.2/5.0

    Scored across 8 tools

    Disambiguation3/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers