caja de herramientas de py-mcp-youtube

insignia de herrería Versión Licencia

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 Music MCP

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:
  1. Vaya a "API y servicios" > "Biblioteca".
  2. Busque y habilite "YouTube Data API v3"
- Crear credenciales:
  1. Vaya a "API y servicios" > "Credenciales".
  2. Haga clic en "Crear credenciales" > "Clave API".
  3. 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:

mcp run server.py

Ejecute el inspector MCP:

mcp dev server.py

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ón
get_related_videos : Encuentra vídeos relacionados con un vídeo específico de YouTube
get_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 disponibles
youtube://video/{video_id} : Obtenga información detallada sobre un video específico
youtube://channel/{channel_id} : Obtener información sobre un canal específico
youtube://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

YouTube Toolbox