YouTube MCP Server

by Nocodeboy
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Includes support link integration, allowing users to support the developer through the Buy Me A Coffee platform.

  • Provides tools to interact with the YouTube API, including searching for videos, retrieving video details, searching for channels, and obtaining channel information.

Servidor MCP de YouTube

Este es un servidor MCP (Protocolo de Contexto de Modelo) que permite a Claude y a otros asistentes de IA interactuar con la API de YouTube. El servidor proporciona herramientas para buscar vídeos, obtener detalles sobre vídeos específicos, buscar canales y obtener información detallada sobre ellos.

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto desarrollado por Anthropic (creadores de Claude) para conectar asistentes de IA con fuentes de datos y herramientas externas. Permite a modelos como Claude acceder a información actualizada y realizar acciones en sistemas externos de forma estandarizada.

MCP funciona como un "puente universal" para la IA, proporcionando una forma estandarizada para que los modelos accedan a diversos repositorios de contenido, servicios comerciales o aplicaciones.

Requisitos

  • Node.js v16 o superior
  • Una clave API de YouTube (obtenida desde la Consola para desarrolladores de Google)

Instalación

  1. Clonar este repositorio:
git clone https://github.com/Nocodeboy/youtube-mcp-server.git cd youtube-mcp-server
  1. Instalar dependencias:
npm install
  1. Crea un archivo .env en la raíz del proyecto y agrega tu clave API de YouTube:
YOUTUBE_API_KEY=your_api_key_here

Ejecución

Para iniciar el servidor, ejecute:

npm start

Integración con Claude Desktop

Para usar este servidor MCP con Claude Desktop, agregue la siguiente configuración a su archivo claude_desktop_config.json (generalmente ubicado en %APPDATA%\Claude\ en Windows o ~/Library/Application Support/Claude/ en macOS):

{ "mcpServers": { "youtube": { "command": "node", "args": ["path/to/youtube-mcp-server/index.js"], "env": { "YOUTUBE_API_KEY": "your_api_key_here" } } } }

Reemplace "path/to/youtube-mcp-server/index.js" con la ruta absoluta al archivo index.js y "your_api_key_here" con su clave API de YouTube.

Herramientas disponibles

1. Buscar vídeos

Busque vídeos en YouTube en función de una consulta.

search_videos

Parámetros:

  • query (cadena, obligatoria): Términos de búsqueda
  • maxResults (número, opcional): Número máximo de resultados (entre 1 y 50)
  • pageToken (cadena, opcional): Token para obtener la siguiente página de resultados

2. Obtener detalles del video

Obtenga información detallada sobre un vídeo específico.

get_video_details

Parámetros:

  • videoId (cadena, obligatoria): ID de video de YouTube

3. Obtener detalles del canal

Obtenga información detallada sobre un canal específico.

get_channel_details

Parámetros:

  • channelId (cadena, obligatoria): ID del canal de YouTube

4. Canales de búsqueda

Busque canales en YouTube en función de una consulta.

search_channels

Parámetros:

  • query (cadena, obligatoria): Términos de búsqueda
  • maxResults (número, opcional): Número máximo de resultados (entre 1 y 50)
  • pageToken (cadena, opcional): Token para obtener la siguiente página de resultados

Recursos disponibles

  • youtube://popular/videos : Lista de videos actualmente populares en YouTube

Ejemplos de uso

Con Claude Desktop, puedes hacer preguntas como:

  • Buscar vídeos de programación en Python
  • "Muéstrame los detalles del video con ID dQw4w9WgXcQ"
  • "Buscar canales relacionados con la cocina"
  • "Dame información sobre el canal de Google Developers"
  • "¿Cuáles son los vídeos más populares en este momento?"

Obtener una clave API de YouTube

Para obtener una clave API de YouTube:

  1. Vaya a la Consola para desarrolladores de Google
  2. Crear un nuevo proyecto (o seleccionar uno existente)
  3. En la barra lateral, seleccione "Biblioteca API"
  4. Busque "YouTube Data API v3" y habilítelo
  5. En la barra lateral, seleccione "Credenciales".
  6. Haga clic en "Crear credenciales" y seleccione "Clave API".
  7. Copia la clave generada y úsala en tu archivo .env o en la configuración de Claude Desktop

Solución de problemas

Si encuentra errores, verifique:

  1. Que hayas instalado todas las dependencias con npm install
  2. Que tu clave API de YouTube sea válida
  3. Que tengas habilitada la API de datos de YouTube v3 en tu proyecto de Google
  4. Que estás utilizando Node.js versión 16 o superior
  5. Si usa Claude Desktop, verifique los registros en %APPDATA%\Claude\logs\ (Windows) o ~/Library/Logs/Claude/ (macOS)

Contribuciones

Se agradecen las contribuciones. Puedes colaborar de varias maneras:

  1. Informar errores o problemas
  2. Sugerir nuevas funciones
  3. Envío de solicitudes de extracción con mejoras o correcciones
  4. Mejorar la documentación

Conectar y apoyar

  • Sígueme en X (Twitter): @Nocodeboy
  • Si te parece útil este proyecto y quieres mostrar tu apoyo:

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor MCP que permite a Claude y otros asistentes de IA interactuar con la API de YouTube, proporcionando herramientas para buscar videos/canales y recuperar información detallada sobre ellos.

  1. What is MCP?
    1. Requirements
      1. Installation
        1. Execution
          1. Integration with Claude Desktop
            1. Available Tools
              1. 1. Search Videos
              2. 2. Get Video Details
              3. 3. Get Channel Details
              4. 4. Search Channels
            2. Available Resources
              1. Usage Examples
                1. Getting a YouTube API Key
                  1. Troubleshooting
                    1. Contributions
                      1. Connect & Support
                        1. License
                          ID: gruax1wz8k