Servidor MCP de YouTube
Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con vídeos de YouTube. Este servidor proporciona herramientas para extraer metadatos y subtítulos de vídeo, y convertirlos a formato Markdown con diversas plantillas.
Características
- Metadatos de video : obtenga información completa del video
- Extracción de subtítulos : compatibilidad con subtítulos generados automáticamente y manualmente
- Varios idiomas : soporte integrado para inglés y francés
- Sistema de plantillas : tres plantillas de rebajas integradas:
- Básico: Formato de transcripción simple
- Detallado: metadatos completos con marcas de tiempo
- Búsqueda: Resultados resaltados con contexto
- Función de búsqueda : Buscar dentro de los subtítulos de los videos
- Autenticación flexible : admite tanto la clave API como la autenticación OAuth2
Prerrequisitos
- Node.js (v16 o superior)
- npm o hilo
- Una clave de API de datos de YouTube y/o credenciales OAuth2
Instalación
- Clonar el repositorio:
git clone [repository-url]
cd youtube-mcp
- Instalar dependencias:
- Construir el proyecto:
Configuración
Crea un archivo .env en el directorio raíz con tus credenciales de YouTube:
YOUTUBE_API_KEY=your_api_key
YOUTUBE_CLIENT_ID=your_client_id
YOUTUBE_CLIENT_SECRET=your_client_secret
YOUTUBE_REFRESH_TOKEN=your_refresh_token # Optional, for OAuth2
Configuración de MCP
Agregue el servidor a su archivo de configuración de MCP (generalmente en ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json ):
{
"mcpServers": {
"youtube": {
"command": "node",
"args": ["path/to/youtube-mcp/build/index.js"],
"env": {
"YOUTUBE_API_KEY": "your_api_key",
"YOUTUBE_CLIENT_ID": "your_client_id",
"YOUTUBE_CLIENT_SECRET": "your_client_secret"
},
"disabled": false,
"alwaysAllow": []
}
}
}
Uso
El servidor proporciona las siguientes herramientas:
use_mcp_tool youtube get_video_info {
"url": "https://www.youtube.com/watch?v=VIDEO_ID"
}
2. Obtener subtítulos
use_mcp_tool youtube get_captions {
"url": "https://www.youtube.com/watch?v=VIDEO_ID",
"language": "en" // Optional, defaults to "en"
}
3. Convertir a Markdown
use_mcp_tool youtube convert_to_markdown {
"url": "https://www.youtube.com/watch?v=VIDEO_ID",
"template_name": "detailed", // Optional, "basic", "detailed", or "search"
"language": "en", // Optional
"options": { // Optional
"include_chapters": true,
"search_term": "keyword" // Only for search template
}
}
4. Plantillas de lista
use_mcp_tool youtube list_templates
Dependencias
{
"dependencies": {
"@modelcontextprotocol/sdk": "latest",
"googleapis": "^146.0.0",
"google-auth-library": "^9.0.0",
"youtube-captions-scraper": "^2.0.0",
"express": "^4.18.2",
"open": "^9.1.0"
},
"devDependencies": {
"@types/node": "^20.0.0",
"typescript": "^5.0.0",
"tsx": "^4.0.0"
}
}
Configuración de OAuth2
Para la autenticación OAuth2 (necesaria para el acceso a video privado):
- Crear un proyecto en Google Cloud Console
- Habilitar la API de datos de YouTube v3
- Crear credenciales OAuth2 (tipo de aplicación web)
- Ejecute el script de autenticación:
- Siga las instrucciones del navegador para autorizar la aplicación.
- Copia el token de actualización a tu configuración
Personalización de plantillas
Puedes agregar plantillas personalizadas modificando la matriz DEFAULT_TEMPLATES en src/index.ts . Las plantillas siguen esta estructura:
interface MarkdownTemplate {
name: string;
description: string;
format: {
header?: string;
chapter_format?: string;
caption_block: string;
timestamp_format?: string;
search_result_format?: string;
}
}
Licencia
Instituto Tecnológico de Massachusetts (MIT)
Contribuyendo
- Bifurcar el repositorio
- Crea tu rama de funciones (
git checkout -b feature/amazing-feature ) - Confirme sus cambios (
git commit -m 'Add some amazing feature' ) - Empujar a la rama (
git push origin feature/amazing-feature ) - Abrir una solicitud de extracción