Servidor MCP de YouTube
Una implementación de servidor de Protocolo de contexto de modelo (MCP) para YouTube, que permite que los modelos de lenguaje de IA interactúen con el contenido de YouTube a través de una interfaz estandarizada.
Características
- Obtenga detalles del video (título, descripción, duración, etc.)
- Lista de vídeos del canal
- Obtener estadísticas de vídeo (visualizaciones, me gusta, comentarios)
- Buscar vídeos en YouTube
Gestión de transcripciones
- Recuperar transcripciones de vídeo
- Soporte para múltiples idiomas
- Obtener subtítulos con marca de tiempo
- Buscar dentro de las transcripciones
Gestión de canales
- Obtener detalles del canal
- Lista de reproducción de canales
- Obtener estadísticas del canal
- Buscar dentro del contenido del canal
Gestión de listas de reproducción
- Lista de elementos de la lista de reproducción
- Obtener detalles de la lista de reproducción
- Buscar dentro de las listas de reproducción
- Obtener transcripciones de videos de listas de reproducción
Instalación
Para instalar YouTube MCP Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @ZubeidHendricks/youtube --client claude
Instalación manual
npm install zubeid-youtube-mcp-server
Configuración
Establezca las siguientes variables de entorno:
YOUTUBE_API_KEY : Su clave de API de datos de YouTubeYOUTUBE_TRANSCRIPT_LANG : idioma predeterminado para las transcripciones (opcional, el valor predeterminado es 'en')
Uso con el cliente MCP
Agregue esto a la configuración de su cliente MCP (por ejemplo, Claude Desktop):
{
"mcpServers": {
"youtube": {
"command": "npx",
"args": ["-y", "zubeid-youtube-mcp-server"],
"env": {
"YOUTUBE_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
Uso con VS Code
Para la instalación con un solo clic, haga clic en uno de los botones de instalación a continuación:
Instalación manual
Si prefiere la instalación manual, primero revise los botones de instalación en la parte superior de esta sección. De lo contrario, siga estos pasos:
Agrega el siguiente bloque JSON a tu archivo de configuración de usuario (JSON) en VS Code. Para ello, presiona Ctrl + Shift + P y escribe Preferences: Open User Settings (JSON) .
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "apiKey",
"description": "YouTube API Key",
"password": true
}
],
"servers": {
"youtube": {
"command": "npx",
"args": ["-y", "zubeid-youtube-mcp-server"],
"env": {
"YOUTUBE_API_KEY": "${input:apiKey}"
}
}
}
}
}
Opcionalmente, puede agregarlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo:
{
"inputs": [
{
"type": "promptString",
"id": "apiKey",
"description": "YouTube API Key",
"password": true
}
],
"servers": {
"youtube": {
"command": "npx",
"args": ["-y", "zubeid-youtube-mcp-server"],
"env": {
"YOUTUBE_API_KEY": "${input:apiKey}"
}
}
}
}
Configuración de la API de YouTube
- Ir a la consola de Google Cloud
- Crea un nuevo proyecto o selecciona uno existente
- Habilitar la API de datos de YouTube v3
- Crear credenciales de API (clave API)
- Copiar la clave API para la configuración
Ejemplos
Administrar vídeos
// Get video details
const video = await youtube.videos.getVideo({
videoId: "video-id"
});
// Get video transcript
const transcript = await youtube.transcripts.getTranscript({
videoId: "video-id",
language: "en"
});
// Search videos
const searchResults = await youtube.videos.searchVideos({
query: "search term",
maxResults: 10
});
Gestión de canales
// Get channel details
const channel = await youtube.channels.getChannel({
channelId: "channel-id"
});
// List channel videos
const videos = await youtube.channels.listVideos({
channelId: "channel-id",
maxResults: 50
});
Administrar listas de reproducción
// Get playlist items
const playlistItems = await youtube.playlists.getPlaylistItems({
playlistId: "playlist-id",
maxResults: 50
});
// Get playlist details
const playlist = await youtube.playlists.getPlaylist({
playlistId: "playlist-id"
});
Desarrollo
# Install dependencies
npm install
# Run tests
npm test
# Build
npm run build
# Lint
npm run lint
Contribuyendo
Consulte CONTRIBUTING.md para obtener información sobre cómo contribuir a este repositorio.
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.