Servidor MCP de YouTube

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con datos de YouTube. Este servidor proporciona recursos y herramientas para consultar vídeos, canales, comentarios y transcripciones de YouTube mediante una interfaz stdio.

Características

Busque vídeos de YouTube con opciones de filtrado avanzadas
Obtenga información detallada sobre vídeos y canales específicos
Comparar estadísticas en varios vídeos
Descubre los vídeos de tendencia por región y categoría
Analizar el rendimiento del canal y las estadísticas de vídeo.
Recuperar comentarios y transcripciones/subtítulos de videos
Generar análisis de video y resúmenes de transcripciones

Prerrequisitos

Node.js (v16+)
Clave API de datos de YouTube

Instalación

Instalación mediante herrería

Para instalar YouTube MCP Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @coyaSONG/youtube-mcp-server --client claude

Instalación manual

Clonar este repositorio:
git clone https://github.com/coyaSONG/youtube-mcp-server.git cd youtube-mcp-server
Instalar dependencias:
npm install
Cree un archivo .env en el directorio raíz:
YOUTUBE_API_KEY=your_youtube_api_key_here PORT=3000

Uso

Construyendo y funcionando

Construir el proyecto:
npm run build
Ejecutar el servidor:
npm start
Ejecutar en modo de desarrollo:
npm run dev
Artefactos de compilación limpia:
npm run clean

Implementación de Docker

El proyecto incluye un Dockerfile para implementación en contenedores:

# Build the Docker image
docker build -t youtube-mcp-server .

# Run the container
docker run -p 3000:3000 --env-file .env youtube-mcp-server

Referencia de API

Recursos

youtube://video/{videoId} - Obtenga información detallada sobre un video específico
youtube://channel/{channelId} - Obtener información sobre un canal específico
youtube://transcript/{videoId} - Obtener la transcripción de un video específico
- Parámetro de consulta opcional: ?language=LANGUAGE_CODE (p. ej., en , ko , ja )

Herramientas

Herramientas básicas

search-videos - Busca vídeos de YouTube con opciones de filtrado avanzadas
get-video-comments - Obtener comentarios para un video específico
get-video-transcript : obtener la transcripción de un video específico con idioma opcional
enhanced-transcript : extracción avanzada de transcripciones con filtrado, búsqueda y capacidades de múltiples videos
get-key-moments : extrae momentos clave con marcas de tiempo de una transcripción de video para facilitar la navegación.
get-segmented-transcript : divide la transcripción de un video en segmentos para facilitar su análisis.

Herramientas estadísticas

get-video-stats : obtener información estadística de un video específico
get-channel-stats : obtén el número de suscriptores, el número de visualizaciones y otras estadísticas del canal
compare-videos : compara estadísticas entre varios videos

Herramientas de descubrimiento

get-trending-videos : recupera videos de tendencia por región y categoría
get-video-categories : obtenga las categorías de video disponibles para una región específica

Herramientas de análisis

analyze-channel-videos : analiza las tendencias de rendimiento de los videos de un canal específico

Indicaciones

video-analysis - Generar un análisis de un vídeo de YouTube
transcript-summary : genera un resumen de un video basado en su transcripción con duración personalizable y extracción de palabras clave.
segment-by-segment-analysis : proporciona un desglose detallado del contenido analizando cada segmento del video.

Ejemplos

Cómo acceder a una transcripción de vídeo

youtube://transcript/dQw4w9WgXcQ

Cómo obtener una transcripción en un idioma específico

youtube://transcript/dQw4w9WgXcQ?language=en

Uso de las herramientas estadísticas

// Get video statistics
{
  "type": "tool",
  "name": "get-video-stats",
  "parameters": {
    "videoId": "dQw4w9WgXcQ"
  }
}

// Compare multiple videos
{
  "type": "tool",
  "name": "compare-videos",
  "parameters": {
    "videoIds": ["dQw4w9WgXcQ", "9bZkp7q19f0"]
  }
}

Cómo usar la solicitud de resumen de transcripción

{
  "type": "prompt",
  "name": "transcript-summary",
  "parameters": {
    "videoId": "dQw4w9WgXcQ",
    "language": "en"
  }
}

Uso de la herramienta de transcripción mejorada

// Basic multi-video transcript extraction
{
  "type": "tool",
  "name": "enhanced-transcript",
  "parameters": {
    "videoIds": ["dQw4w9WgXcQ", "9bZkp7q19f0"],
    "format": "timestamped"
  }
}

// With search and time filtering
{
  "type": "tool",
  "name": "enhanced-transcript",
  "parameters": {
    "videoIds": ["dQw4w9WgXcQ"],
    "filters": {
      "timeRange": {
        "start": 60,  // Start at 60 seconds
        "end": 180    // End at 180 seconds
      },
      "search": {
        "query": "never gonna",
        "contextLines": 2
      }
    },
    "format": "merged"
  }
}

// With smart segmentation for easier analysis
{
  "type": "tool",
  "name": "enhanced-transcript",
  "parameters": {
    "videoIds": ["dQw4w9WgXcQ"],
    "filters": {
      "segment": {
        "count": 5,
        "method": "smart"  // Breaks at natural pauses
      }
    },
    "format": "timestamped",
    "language": "en"
  }
}

Uso de las funciones de análisis de transcripciones mejoradas

// Get key moments from a video
{
  "type": "tool",
  "name": "get-key-moments",
  "parameters": {
    "videoId": "dQw4w9WgXcQ",
    "maxMoments": "5"
  }
}

// Get a segmented transcript
{
  "type": "tool",
  "name": "get-segmented-transcript",
  "parameters": {
    "videoId": "dQw4w9WgXcQ",
    "segmentCount": "4"
  }
}

// Get a segment-by-segment analysis
{
  "type": "prompt",
  "name": "segment-by-segment-analysis",
  "parameters": {
    "videoId": "dQw4w9WgXcQ",
    "segmentCount": "4"
  }
}

// Get customized transcript summary
{
  "type": "prompt",
  "name": "transcript-summary",
  "parameters": {
    "videoId": "dQw4w9WgXcQ",
    "language": "en",
    "summaryLength": "detailed",
    "includeKeywords": "true"
  }
}

Manejo de errores

El servidor maneja varias condiciones de error, entre ellas:

Clave API no válida
Vídeo o canal no encontrado
Transcripción no disponible
Problemas de red

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Expresiones de gratitud

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Un servidor que permite la interacción con datos de YouTube a través del Protocolo de Contexto de Modelo, permitiendo a los usuarios buscar videos, recuperar información detallada sobre videos/canales y obtener comentarios.

Related MCP Servers

mcp-server-youtube-transcript
kimtaeyoon83
A
security
A
license
A
quality
A Model Context Protocol server that enables retrieval of transcripts from YouTube videos. This server provides direct access to video captions and subtitles through a simple interface.
Last updated -
1
526
189
JavaScript
MIT License
MCP YouTube Server
DimitriGeelen
-
security
F
license
-
quality
A server for downloading, processing, and managing YouTube content with features like video quality selection, format conversion, and metadata extraction.
Last updated -
JavaScript
YouTube Translate MCP
brianshin22
-
security
-
license
-
quality
A Model Context Protocol server that enables access to YouTube video content through transcripts, translations, summaries, and subtitle generation in various languages.
Last updated -
Python
MIT License
mcp-youtube-transcript
sinco-lab
A
security
A
license
A
quality
A Model Context Protocol server that enables retrieval of transcripts from YouTube videos. This server provides direct access to video transcripts and subtitles through a simple interface, making it ideal for content analysis and processing.
Last updated -
1
258
10
TypeScript
MIT License

View all related MCP servers

YouTube MCP Server