Servidor de transcripciones de YouTube de MCP

Un servidor de Protocolo de Contexto de Modelo que permite la recuperación de transcripciones de vídeos de YouTube. Este servidor proporciona acceso directo a las transcripciones de vídeo mediante una interfaz sencilla, lo que lo hace ideal para el análisis y procesamiento de contenido.

Características

✨ Capacidades clave:

Extraer transcripciones de vídeos de YouTube
Soporte para múltiples idiomas
Formatear texto con modo continuo o de párrafo
Recuperar títulos y metadatos de vídeos
Segmentación automática de párrafos
Normalización de texto y decodificación de entidades HTML
Manejo robusto de errores
Detección de marcas de tiempo y superposición

Empezando

Prerrequisitos

Node.js 18 o superior

Instalación

Ofrecemos dos métodos de instalación:

Opción 1: Configuración manual (recomendada para producción)

Cree o edite el archivo de configuración de Claude Desktop:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Ventanas: %APPDATA%\Claude\claude_desktop_config.json
Agregue la siguiente configuración:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "-y",
        "@sinco-lab/mcp-youtube-transcript"
      ]
    }
  }
}

Script de configuración rápida para macOS:

# Create directory if it doesn't exist
mkdir -p ~/Library/Application\ Support/Claude

# Create or update config file
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json << 'EOL'
{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "-y",
        "@sinco-lab/mcp-youtube-transcript"
      ]
    }
  }
}
EOL

Opción 2: Vía Herrería (Solo Desarrollo)

npx -y @smithery/cli install @sinco-lab/mcp-youtube-transcript --client claude

⚠️ Nota : Este método no se recomienda para uso en producción ya que depende de los servicios de proxy de Smithery.

Uso

Configuración básica

Para utilizar con Claude Desktop/Cursor/cline, asegúrese de que su configuración coincida:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@sinco-lab/mcp-youtube-transcript"]
    }
  }
}

Pruebas

Con la aplicación Claude

Reinicie la aplicación Claude después de la instalación
Prueba con un comando simple:
https://www.youtube.com/watch?v=AJpK3YTTKZ4 Summarize this video

Ejemplo de salida:

Con MCP Inspector

# Clone and setup
git clone https://github.com/sinco-lab/mcp-youtube-transcript.git
cd mcp-youtube-transcript
npm install
npm run build

# Launch inspector
npx @modelcontextprotocol/inspector node "dist/index.js"

# Access http://localhost:5173 and try these commands:
# 1. List Tools: clink `List Tools`
# 2. Test get_transcripts with:
#    url: "https://www.youtube.com/watch?v=AJpK3YTTKZ4"
#    lang: "en" (optional)
#    enableParagraphs: false (optional)

Solución de problemas y mantenimiento

Comprobación de los registros de Claude

Para supervisar los registros de Claude, puede utilizar el siguiente comando:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Esto mostrará las últimas 20 líneas del archivo de registro y continuará mostrando nuevas entradas a medida que se agreguen.

Nota : La aplicación Claude prefija automáticamente los archivos de registro del servidor MCP con mcp-server- . Por ejemplo, los registros de nuestro servidor se escribirán en mcp-server-youtube-transcript.log .

Limpieza de la caché `npx`

Si encuentra problemas relacionados con el caché npx , puede limpiarlo manualmente usando:

rm -rf ~/.npm/_npx

Esto eliminará los paquetes almacenados en caché y le permitirá comenzar de nuevo.

Referencia de API

obtener_transcripciones

Obtiene transcripciones de vídeos de YouTube.

Parámetros:

url (cadena, obligatoria): URL o ID del video de YouTube
lang (cadena, opcional): Código de idioma (predeterminado: "en")
enableParagraphs (booleano, opcional): Habilitar el modo de párrafo (predeterminado: falso)

Formato de respuesta:

{
  "content": [{
    "type": "text",
    "text": "Video title and transcript content",
    "metadata": {
      "videoId": "video_id",
      "title": "video_title",
      "language": "transcript_language",
      "timestamp": "processing_time",
      "charCount": "character_count",
      "transcriptCount": "number_of_transcripts",
      "totalDuration": "total_duration",
      "paragraphsEnabled": "paragraph_mode_status"
    }
  }]
}

Desarrollo

Estructura del proyecto

├── src/
│ ├── index.ts            # Server entry point
│ ├── youtube.ts          # YouTube transcript fetching logic
├── dist/                 # Compiled output
└── package.json

Componentes clave

YouTubeTranscriptFetcher : Funcionalidad principal para obtener transcripciones
YouTubeUtils : Procesamiento de texto y utilidades

Características y capacidades

Manejo de errores:
- URL/ID no válidos
- Transcripciones no disponibles
- Disponibilidad de idiomas
- Errores de red
- Limitación de velocidad
Procesamiento de texto:
- Decodificación de entidades HTML
- Normalización de la puntuación
- Normalización espacial
- Detección inteligente de párrafos

Contribuyendo

¡Agradecemos las contribuciones! No dudes en enviar problemas y solicitudes de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

mcp-youtube-transcript

Integrations

Servidor de transcripciones de YouTube de MCP

Tabla de contenido

Características

Empezando

Prerrequisitos

Instalación

Opción 1: Configuración manual (recomendada para producción)

Opción 2: Vía Herrería (Solo Desarrollo)

Uso

Configuración básica

Pruebas

Con la aplicación Claude

Con MCP Inspector

Solución de problemas y mantenimiento

Comprobación de los registros de Claude

Limpieza de la caché `npx`

Referencia de API

obtener_transcripciones

Desarrollo

Estructura del proyecto

Componentes clave

Características y capacidades

Contribuyendo

Licencia

Proyectos relacionados

Tools

Related Resources

Integrations

Servidor de transcripciones de YouTube de MCP

Tabla de contenido

Características

Empezando

Prerrequisitos

Instalación

Opción 1: Configuración manual (recomendada para producción)

Opción 2: Vía Herrería (Solo Desarrollo)

Uso

Configuración básica

Pruebas

Con la aplicación Claude

Con MCP Inspector

Solución de problemas y mantenimiento

Comprobación de los registros de Claude

Limpieza de la caché npx

Referencia de API

obtener_transcripciones

Desarrollo

Estructura del proyecto

Componentes clave

Características y capacidades

Contribuyendo

Licencia

Proyectos relacionados

Tools

Related Resources

Limpieza de la caché `npx`