Extractor de transcripciones de YouTube MCP 🎥

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA extraer transcripciones de vídeos de YouTube. Diseñada para integrarse con Cursor y Claude Desktop, esta herramienta permite a la IA analizar y trabajar directamente con el contenido de vídeo de YouTube.

Características

🎯 Extrae transcripciones de cualquier vídeo público de YouTube
🔌 Fácil integración con Cursor y Claude Desktop
🚀 Creado con TypeScript para seguridad de tipos
📦 Configuración e implementación sencillas
🛠️ Basado en el Protocolo de Contexto Modelo

Related MCP server: YouTube Transcript Server

Prerrequisitos

Node.js (v16 o superior)
pnpm (recomendado) o npm
Una URL de video de YouTube para extraer transcripciones

Instalación

Clonar el repositorio:

git clone https://github.com/yourusername/yt-mcp.git cd yt-mcp

Instalar dependencias:

pnpm install

Construir el proyecto:

pnpm run build

Configuración

Para el cursor

Abrir configuración del cursor
Vaya a MCP → Agregar nuevo servidor MCP
Configure con estos ajustes:
- Nombre: youtube-transcript
- Tipo: command
- Comando: node /absolute/path/to/yt-mcp/build/index.js

Para Claude Desktop

Agregue esta configuración a su configuración de Claude Desktop:

{ "mcpServers": { "youtube-transcript": { "command": "node", "args": ["/absolute/path/to/yt-mcp/build/index.js"] } } }

Uso

Una vez configurada, la IA puede extraer transcripciones de vídeos de YouTube llamando a la herramienta con la URL del vídeo. Ejemplo:

// The AI will use this format internally const transcript = await extractTranscript({ input: "https://www.youtube.com/watch?v=VIDEO_ID" });

Detalles técnicos

El servidor está construido utilizando:

@modelcontextprotocol/sdk - Para la implementación de MCP
youtube-transcript - Para la extracción de transcripciones
TypeScript: para seguridad de tipos y una mejor experiencia de desarrollo

Limitaciones

Solo funciona con vídeos públicos de YouTube.
Los videos deben tener subtítulos habilitados
Algunos videos pueden tener subtítulos generados automáticamente que podrían no ser 100% precisos.

Solución de problemas

Problemas comunes y soluciones:

Error "No se puede encontrar la identificación del video"
- Asegúrese de que la URL de YouTube esté completa y sea correcta
- Comprueba si el vídeo es de acceso público
Error "No hay transcripción disponible"
- Verifique que el video tenga subtítulos habilitados
- Pruebe con un video diferente para confirmar que la herramienta funciona
Errores de compilación
- Asegúrese de que todas las dependencias estén instaladas
- Verifique la versión de Node.js (debe ser v16 o superior)

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios. Para cambios importantes, primero abra una incidencia para comentar qué desea cambiar.