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
Tabla de contenido
Prerrequisitos
- Python : Instale Python 3.12 o superior
- Clave API de YouTube :
- Ir a la consola de Google Cloud
- 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-toolbox
Configuración
- Instalar el administrador de paquetes UV:
curl -LsSf https://astral.sh/uv/install.sh | sh
- Crear y activar entorno virtual:
uv venv -p 3.12
source .venv/bin/activate # On MacOS/Linux
# or
.venv\Scripts\activate # On Windows
- Instalar dependencias:
uv pip install -r requirements.txt
- Variables de entorno:
cp env.example .env
vi .env
# Update with your YouTube API key
YOUTUBE_API_KEY=your_youtube_api_key
Usando 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-toolbox
Uso local
- Ejecutar el servidor:
- Ejecute el inspector MCP:
Configurar 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 claude
- Para 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