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

Información del vídeo

• 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

Related MCP server: mcp-youtube-transcript

Instalación

Instalación mediante herrería

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 YouTube

• YOUTUBE_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

1. Ir a la consola de Google Cloud

2. Crea un nuevo proyecto o selecciona uno existente

3. Habilitar la API de datos de YouTube v3

4. Crear credenciales de API (clave API)

5. 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.