-
securityF
license-
qualityA server for downloading, processing, and managing YouTube content with features like video quality selection, format conversion, and metadata extraction.
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:
npm install
Construir el proyecto:
npm run build
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:
1. Obtener información del video
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:
node src/get-api-key.js
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
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
Permite la interacción con videos de YouTube extrayendo metadatos, subtítulos en varios idiomas y convirtiendo contenido a Markdown con varias plantillas.
Related MCP Servers
- -securityFlicense-qualityEnables extraction of transcript text from YouTube videos by providing the video URL, supporting standard, shortened, and embed URL formats.Last updated -71
- -securityFlicense-qualityEnables AI language models to interact with YouTube content through a standardized interface, providing tools for retrieving video information, transcripts, channel analytics, and trend analysis.Last updated -55447
- -securityAlicense-qualityEnables AI models like Claude to easily access and utilize subtitle data from YouTube videos by extracting transcripts from video URLs with support for multiple languages.Last updated -1MIT License