YouTube Toolbox
caja de herramientas de py-mcp-youtube
Un servidor MCP que proporciona a los asistentes de IA herramientas poderosas para interactuar con YouTube, incluida la búsqueda de videos, la extracción de transcripciones, la recuperación de comentarios y más.
Descripción general
py-mcp-youtube-toolbox proporciona las siguientes funcionalidades relacionadas con YouTube:
Busque vídeos de YouTube con opciones de filtrado avanzadas
Obtenga información detallada sobre vídeos y canales
Recuperar comentarios de vídeo con opciones de clasificación
Extraiga transcripciones de videos y subtítulos en varios idiomas.
Buscar vídeos relacionados con un vídeo determinado
Obtenga videos de tendencia por región
Generar resúmenes de contenido de video basados en transcripciones
Análisis avanzado de transcripciones con filtrado, búsqueda y capacidades de múltiples videos
Related MCP server: YouTube MCP Server
Tabla de contenido
Prerrequisitos
Python : Instale Python 3.12 o superior
Clave API de YouTube :
Crea un nuevo proyecto o selecciona uno existente
Habilitar la API de datos de YouTube v3:
Vaya a "API y servicios" > "Biblioteca".
Busque y habilite "YouTube Data API v3"
Crear credenciales:
Vaya a "API y servicios" > "Credenciales".
Haga clic en "Crear credenciales" > "Clave API".
Anota tu clave API
Instalación
Clon de Git
git clone https://github.com/jikime/py-mcp-youtube-toolbox.git
cd py-mcp-youtube-toolboxConfiguración
Instalar el administrador de paquetes UV:
curl -LsSf https://astral.sh/uv/install.sh | shCrear y activar entorno virtual:
uv venv -p 3.12
source .venv/bin/activate # On MacOS/Linux
# or
.venv\Scripts\activate # On WindowsInstalar dependencias:
uv pip install -r requirements.txtVariables de entorno:
cp env.example .env
vi .env
# Update with your YouTube API key
YOUTUBE_API_KEY=your_youtube_api_keyUsando Docker
Construya la imagen de Docker:
docker build -t py-mcp-youtube-toolbox .Ejecute el contenedor:
docker run -e YOUTUBE_API_KEY=your_youtube_api_key py-mcp-youtube-toolboxUso local
Ejecutar el servidor:
mcp run server.pyEjecute el inspector MCP:
mcp dev server.pyConfigurar los ajustes de MCP
Agregue la configuración del servidor a su archivo de configuración de MCP:
Aplicación de escritorio de Claude
Para instalar automáticamente a través de Smithery :
npx -y @smithery/cli install @jikime/py-mcp-youtube-toolbox --client claudePara instalar manualmente, abra
~/Library/Application Support/Claude/claude_desktop_config.json
Agregue esto al objeto 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 de cursor
abrir ~/.cursor/mcp.json
Agregue esto al objeto 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"
}
}
}
}para Docker
{
"mcpServers": {
"YouTube Toolbox": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e", "YOUTUBE_API_KEY=your_youtube_api_key",
"py-mcp-youtube-toolbox"
]
}
}
}Documentación de herramientas
Herramientas de vídeo
search_videos: Busca vídeos de YouTube con opciones de filtrado avanzadas (canal, duración, región, etc.)get_video_details: obtiene información detallada sobre un video específico de YouTube (título, canal, vistas, me gusta, etc.)get_video_comments: recupera comentarios de un vídeo de YouTube con opciones de clasificaciónget_related_videos: Encuentra vídeos relacionados con un vídeo específico de YouTubeget_trending_videos: Obtén videos de tendencia en YouTube por región
Herramientas de canal
get_channel_details: obtiene información detallada sobre un canal de YouTube (nombre, suscriptores, vistas, etc.)
Herramientas de transcripción
get_video_transcript: Extrae transcripciones y subtítulos de vídeos de YouTube en los idiomas especificados.get_video_enhanced_transcript: Extracción avanzada de transcripciones con filtrado, búsqueda y capacidades de múltiples videos
Herramientas de aviso
transcript_summary: Genera resúmenes de contenido de videos de YouTube basados en transcripciones con opciones personalizables
Herramientas de recursos
youtube://available-youtube-tools: Obtenga una lista de todas las herramientas de YouTube disponiblesyoutube://video/{video_id}: Obtenga información detallada sobre un video específicoyoutube://channel/{channel_id}: Obtener información sobre un canal específicoyoutube://transcript/{video_id}?language={language}: Obtener la transcripción de un video específico
Desarrollo
Para realizar pruebas locales, puede utilizar el script de cliente incluido:
# 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: Licencia
Licencia 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-