Servidor MCP Remoto de Transcripciones de YouTube

El primer servidor remoto del Model Context Protocol (MCP) que permite a Claude AI extraer transcripciones de vídeos de YouTube. Este servidor ofrece acceso sin configuración para usuarios en cualquier plataforma, incluidos dispositivos móviles.

🌟 Características

• Sin configuración local: No requiere instalación: funciona directamente desde la nube

• Acceso universal: Funciona en las versiones de escritorio, móvil y web de Claude

• Caché inteligente: Sistema de caché eficiente mediante Cloudflare KV para respuestas rápidas

• Soporte multilingüe: Extrae transcripciones en diferentes idiomas

• Gestión de errores: Manejo robusto de errores con mensajes amigables para el usuario

• Analíticas: Seguimiento de solicitudes y analíticas de uso integradas

• Flexibilidad de URL: Gestiona todos los formatos de URL de YouTube (youtube.com, youtu.be, m.youtube.com, etc.)

Related MCP server: ytt-mcp

🚀 Inicio rápido

Opción 1: Usar nuestro servidor alojado (recomendado)

La forma más fácil de empezar: solo tienes que añadir nuestro servidor público a tu Claude Desktop:

Para usuarios de Claude Desktop

1. Abre los ajustes de Claude Desktop

   • Haz clic en "Claude" en la barra de menú → "Ajustes"

   • Ve a la pestaña "Developer"

   • Haz clic en "Edit Config"

2. Añade la configuración del servidor MCP

   Añade esto a tu claude_desktop_config.json:

   {
     "mcpServers": {
       "youtube-transcript": {
         "command": "npx",
         "args": [
           "mcp-remote",
           "https://youtube-transcript-mcp.ergut.workers.dev/sse"
         ]
       }
     }
   }

3. Reinicia Claude Desktop

   Después de guardar el archivo de configuración, reinicia Claude Desktop para cargar el servidor.

4. Verifica la instalación

   Busca el icono de herramientas (🔧) en la interfaz de chat. Deberías ver la herramienta get_transcript disponible.

Opción 2: Despliega tu propio servidor

¿Quieres ejecutar tu propia instancia? Despliega en Cloudflare Workers con un clic:

O manualmente:

git clone https://github.com/ergut/youtube-transcript-mcp
cd youtube-transcript-mcp
npm install
npm run deploy

Para otros clientes MCP

El servidor admite el protocolo MCP estándar y puede usarse con cualquier cliente compatible:

• URL pública del servidor: https://youtube-transcript-mcp.ergut.workers.dev/sse

• Transporte: Server-Sent Events (SSE) o HTTP

• Autenticación: No se requiere (servidor público)

📖 Ejemplos de uso

Extracción básica de transcripciones

Extract the transcript from this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ

Soporte multilingüe

Can you get the transcript of this video in Turkish: https://youtu.be/VIDEO_ID

Extract the Spanish transcript from: https://www.youtube.com/watch?v=VIDEO_ID

Formatos de URL admitidos

El servidor gestiona automáticamente todos los formatos de URL de YouTube:

• https://www.youtube.com/watch?v=VIDEO_ID

• https://youtu.be/VIDEO_ID

• https://m.youtube.com/watch?v=VIDEO_ID

• https://www.youtube.com/live/VIDEO_ID

• https://www.youtube.com/embed/VIDEO_ID

• https://www.youtube.com/shorts/VIDEO_ID

• Dominios internacionales (youtube.co.uk, youtube.de, etc.)

Todos los parámetros de seguimiento (?si=, &t=, etc.) se eliminan automáticamente.

🛠 Herramientas disponibles

get_transcript

Extrae la transcripción de la URL de un vídeo de YouTube.

Parámetros:

• url (obligatorio): URL del vídeo de YouTube en cualquier formato

• language (opcional): Código de idioma para la transcripción (p. ej., 'en', 'es', 'fr'). El valor predeterminado es 'en'.

Ejemplo de uso:

{
  "name": "get_transcript",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "language": "en"
  }
}

🔧 Configuración avanzada

Registro de depuración

Para habilitar el registro detallado:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://youtube-transcript-mcp.ergut.workers.dev/sse",
        "--debug"
      ]
    }
  }
}

Los registros de depuración se crearán en ~/.mcp.log.

Solo transporte HTTP

Para forzar el transporte HTTP en lugar de SSE:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://youtube-transcript-mcp.ergut.workers.dev/mcp",
        "--transport",
        "http-only"
      ]
    }
  }
}

📊 Análisis

El servidor incluye análisis integrados para realizar un seguimiento de las solicitudes. Para verlos:

curl -X POST https://youtube-transcript-mcp.ergut.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_transcript",
      "arguments": {
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "language": "en"
      }
    }
  }'

🌍 Idiomas admitidos

El servidor admite cualquier idioma para el que YouTube proporcione transcripciones. Códigos de idioma más comunes:

• en — Inglés (predeterminado)

• es — Español

• fr — Francés

• de — Alemán

• it — Italiano

• pt — Portugués

• nl — Neerlandés

• ja — Japonés

• ko — Coreano

• zh — Chino

🔒 Privacidad y seguridad

• Sin autenticación requerida: Servidor público para facilitar su uso

• Sin almacenamiento de datos: Las transcripciones solo se almacenan en caché temporalmente por motivos de rendimiento

• Sin información personal: Solo se procesan IDs de vídeo de YouTube y transcripciones

• Solo HTTPS: Todas las comunicaciones están cifradas

• Compatibilidad con CORS: Admite clientes MCP basados en web

🚨 Manejo de errores

El servidor proporciona mensajes de error claros para problemas comunes:

• "Invalid YouTube URL provided": El formato de la URL no es reconocido

• "No transcript available for this video": El vídeo no tiene subtítulos/transcripción

• "Video is unavailable": El vídeo es privado, ha sido eliminado o no existe

• "Transcripts are disabled for this video": El creador ha desactivado los subtítulos

• "Language not available": El idioma solicitado no está disponible para este vídeo

• "Service temporarily busy, try again in a few minutes": Límite de velocidad o problema temporal del servicio

🚀 Puntos de acceso de la API

Para desarrolladores que quieran integrarse directamente:

Publicar /api/transcript

Punto de acceso REST para extracción de transcripciones.

Solicitud de ejemplo:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://youtube-transcript-mcp.ergut.workers.dev/mcp",
        "--transport",
        "http-only"
      ]
    }
  }
}

Respuesta de ejemplo:

curl -X POST https://youtube-transcript-mcp.ergut.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_transcript",
      "arguments": {
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "language": "en"
      }
    }
  }'

Publicar /api/health

Punto de acceso de comprobación de estado.

git clone https://github.com/ergut/youtube-transcript-mcp
cd youtube-transcript-mcp
npm install
npm run dev

🐛 Solución de problemas

Problemas comunes

1. "Connection Error" en Claude Desktop

   • Asegúrate de tener la última versión de Claude Desktop

   • Comprueba que mcp-remote está instalado correctamente

   • Verifica tu conexión a Internet

2. "Could not attach to MCP server"

   • Verifica que la URL del servidor es correcta

   • Comprueba tu conexión a Internet

   • Espera unos minutos y vuelve a intentarlo (el servidor puede estar arrancando)

3. No se devuelve ninguna transcripción

   • Verifica que la URL del vídeo de YouTube es válida

   • Comprueba si el vídeo tiene subtítulos disponibles

   • Prueba con un código de idioma diferente

Cómo obtener ayuda

• Comprueba el estado del servidor: Visita https://youtube-transcript-mcp.ergut.workers.dev/

• Prueba la conexión: Usa el punto de acceso /api/health

• Abre un issue: GitHub Issues

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Así puedes contribuir:

• Reporta errores: Abre un issue en GitHub

• Sugiere funciones: Usa la sección de issues para proponer mejoras

• Pull Requests: Envía PRs para correcciones y nuevas funciones

Configuración del desarrollo

GXP11

📄 Licencia

Este proyecto tiene licencia MIT - consulta el archivo LICENSE para más detalles.

🙏 Agradecimientos

• Construido con el SDK de TypeScript de Model Context Protocol

• Inspirado en el ecosistema MCP de Anthropic

• Desplegado en Cloudflare Workers

¿Listo para potenciar Claude con transcripciones de YouTube? ¡Añade este servidor a tu configuración de Claude Desktop y empieza a extraer transcripciones de cualquier vídeo de YouTube al instante! 🎉