Skip to main content
Glama
enesjakozh

mcp-youtube-transcript

by sinco-lab
npmGitHub
TypeScript
MIT License
164
26
  • Linux
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Servidor de transcripciones de YouTube de MCP

insignia de herrería

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.

Tabla 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)

  1. 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

  2. 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

  1. Reinicie la aplicación Claude después de la instalación

  2. Prueba con un comando simple:

    https://www.youtube.com/watch?v=AJpK3YTTKZ4 Summarize this video

Ejemplo de salida:Manifestación

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:6274 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.

Proyectos relacionados

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

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

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 y subtítulos de los vídeos mediante una interfaz sencilla, lo que lo hace ideal para el análisis y procesamiento de contenido.

  1. Tabla de contenido
    1. Características
      1. Empezando
        1. Prerrequisitos
        2. Instalación
      2. Uso
        1. Configuración básica
        2. Pruebas
        3. Solución de problemas y mantenimiento
      3. Referencia de API
        1. obtener_transcripciones
      4. Desarrollo
        1. Estructura del proyecto
        2. Componentes clave
        3. Características y capacidades
      5. Contribuyendo
        1. Licencia
          1. Proyectos relacionados

            Related Resources

            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
              361
              316
              MIT License

            • YouTube Transcript Server

              williamvd4
              A
              security
              A
              license
              A
              quality
              A Model Context Protocol server that enables retrieval of transcripts from YouTube videos with language-specific support.
              Last updated -
              1
              361
              MIT License

            • YouTube Transcript Extractor MCP

              MalikElate
              A
              security
              F
              license
              A
              quality
              A Model Context Protocol server that enables AI assistants to extract transcripts from YouTube videos, allowing AI to analyze and work with video content directly.
              Last updated -
              1
              3
              1

            • YouTube Translate MCP

              brianshin22
              A
              security
              A
              license
              A
              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 -
              5
              3
              MIT License

            View all related MCP servers

            Appeared in Searches

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/sinco-lab/mcp-youtube-transcript'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server