YouTube MCP Server

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:

2. Instalar dependencias:

3. Crea un archivo .env en la raíz del proyecto y agrega tu clave API de YouTube:

Ejecución

Para iniciar el servidor, ejecute:

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):

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.

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.

Parámetros:

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

3. Obtener detalles del canal

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

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.

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.