YouTube MCP Server
ยกHola developer ๐๐ป! En este repositorio encontrarรกs ejemplos prรกcticos de cรณmo crear servidores MCP (Model Context Protocol) y usarlos con GitHub Copilot Chat. Aprenderรกs a implementar tanto el transporte stdio como el transporte remoto (SSE) para integrar servicios externos con modelos de lenguaje.
๐ Tabla de Contenidos
- ยฟQuรฉ es Model Context Protocol?
- Componentes del MCP
- Caracterรญsticas
- Tecnologรญas
- Requisitos Previos
- Instalaciรณn
- Uso
- Estructura del Proyecto
- MCP Inspector
- Contribuir
- Sรญgueme
ยฟQuรฉ es Model Context Protocol?
Model Context Protocol (MCP) es un protocolo que permite a los modelos de lenguaje interactuar con otros sistemas y servicios a travรฉs de un conjunto de APIs estandarizadas. Esto permite a los modelos de lenguaje acceder a informaciรณn externa y realizar acciones en otros sistemas, lo que amplรญa su funcionalidad y utilidad. En la documentaciรณn oficial se compara con un USB-C, que permite conectar diferentes dispositivos y sistemas.
Componentes del MCP
- MCP Server: Es el servidor que implementa el protocolo y permite a los modelos de lenguaje interactuar con otros sistemas y servicios. El MCP Server actรบa como intermediario entre el modelo de lenguaje y los sistemas externos.
- MCP Client: Es el cliente que se conecta al MCP Server y envรญa solicitudes para interactuar con otros sistemas y servicios. El MCP Client puede ser un modelo de lenguaje o cualquier otro sistema que necesite interactuar con el MCP Server. Este puede ser la aplicaciรณn de escritorio de Claude o un IDE como Visual Studio Code y GitHub Copilot Chat ๐.
โจ Caracterรญsticas
- ๐ฅ Integraciรณn con YouTube API: Buscar canales de YouTube y obtener informaciรณn detallada
- ๐ Dos implementaciones de transporte: stdio para uso local y SSE para uso remoto
- ๐ ๏ธ Servidor MCP completo: Implementaciรณn funcional del protocolo Model Context Protocol
- ๐ฏ Ejemplos prรกcticos: Cรณdigo listo para usar y adaptar a tus necesidades
- ๐ค Compatible con GitHub Copilot Chat: Integraciรณn directa con tu IDE favorito
- ๐ Cรณdigo TypeScript: Tipado estรกtico para mayor seguridad y mejor experiencia de desarrollo
๐ ๏ธ Tecnologรญas Utilizadas
- Node.js - Runtime de JavaScript
- TypeScript - Superset tipado de JavaScript
- @modelcontextprotocol/sdk - SDK oficial del protocolo MCP
- Google APIs - Cliente oficial de YouTube API v3
- Express - Framework web para el servidor remoto (mcp-remote)
- dotenv - Gestiรณn de variables de entorno
- Zod - Validaciรณn de esquemas
๐ Requisitos Previos
- Node.js v18.0.0 o superior
- npm o yarn instalado
- YouTube API Key - Puedes obtener una desde Google Cloud Console
- GitHub Copilot Chat (opcional) - Para probar la integraciรณn con VS Code
๐ Instalaciรณn
Opciรณn 1: MCP Server con transporte stdio (mcp-stdio)
Este servidor implementa el transporte stdio y permite interactuar con el modelo de lenguaje a travรฉs de la entrada y salida estรกndar.
Paso 1: Clonar el repositorio
git clone https://github.com/0GiS0/youtube-mcp-server.git
cd youtube-mcp-server/mcp-stdio
Paso 2: Instalar dependencias
npm install
Paso 3: Configurar variables de entorno
cp .env-sample .env
Edita el archivo .env y aรฑade tu API Key de YouTube:
YOUTUBE_API_KEY=tu_api_key_aqui
Paso 4: Compilar el proyecto
npm run build
Opciรณn 2: MCP Server remoto con SSE (mcp-remote)
Este servidor implementa el transporte SSE (Server-Sent Events) y permite interactuar con el modelo de lenguaje a travรฉs de eventos del servidor.
Paso 1: Clonar el repositorio
git clone https://github.com/0GiS0/youtube-mcp-server.git
cd youtube-mcp-server/mcp-remote
Paso 2: Instalar dependencias
npm install
Paso 3: Configurar variables de entorno
cp .env-sample .env
Edita el archivo .env y aรฑade tu API Key de YouTube:
YOUTUBE_API_KEY=tu_api_key_aqui
Paso 4: Compilar y ejecutar el proyecto
npm run build
npm start
El servidor estarรก disponible en http://localhost:3000
๐ป Uso
Configurar con GitHub Copilot Chat
Para usar estos servidores MCP con GitHub Copilot Chat, necesitas configurarlos en tu archivo de configuraciรณn de MCP.
Para mcp-stdio:
- Abre la configuraciรณn de GitHub Copilot Chat
- Agrega la configuraciรณn del servidor MCP stdio en tu archivo de configuraciรณn
Para mcp-remote:
- Asegรบrate de que el servidor estรฉ corriendo (
npm start) - Configura GitHub Copilot Chat para conectarse al endpoint del servidor
- El servidor expone las herramientas MCP a travรฉs de HTTP
Ejemplo de herramientas disponibles
El servidor MCP incluye la herramienta get_youtube_channel que permite:
- Buscar canales de YouTube por nombre
- Obtener informaciรณn detallada del canal
- Acceder a estadรญsticas y metadatos
Ejemplo de uso en el chat:
"Busca el canal de YouTube @0GiS0"
El MCP Server procesarรก la solicitud y devolverรก informaciรณn del canal usando la YouTube API.
๐ Estructura del Proyecto
youtube-mcp-server/
โโโ mcp-stdio/ # Servidor MCP con transporte stdio
โ โโโ src/
โ โ โโโ index.ts # Implementaciรณn del servidor stdio
โ โโโ .env-sample # Ejemplo de variables de entorno
โ โโโ package.json # Dependencias del proyecto
โ โโโ tsconfig.json # Configuraciรณn de TypeScript
โโโ mcp-remote/ # Servidor MCP con transporte SSE
โ โโโ src/
โ โ โโโ index.js # Implementaciรณn del servidor remoto
โ โโโ .env-sample # Ejemplo de variables de entorno
โ โโโ Dockerfile # Configuraciรณn para Docker
โ โโโ package.json # Dependencias del proyecto
โ โโโ tsconfig.json # Configuraciรณn de TypeScript
โโโ images/ # Recursos grรกficos
โโโ README.md # Este archivo
๐ MCP Inspector
Para probar un servidor MCP puedes hacerlo usando directamente el Chat de GitHub Copilot, pero hay veces que es mรกs sencillo usar MCP Inspector. Esta herramienta te permite inspeccionar y probar las herramientas del servidor de forma interactiva.
Para lanzarlo, usa este comando:
npx @modelcontextprotocol/inspector
Nota: El Inspector MCP te permite probar las herramientas del servidor, ver los esquemas de entrada/salida y depurar el comportamiento del servidor antes de integrarlo con tu cliente MCP.
๐ค Contribuir
Las contribuciones son bienvenidas. Por favor:
- Fork el repositorio
- Crea una rama para tu feature (
git checkout -b feature/AmazingFeature) - Commit tus cambios (
git commit -m 'Add some AmazingFeature') - Push a la rama (
git push origin feature/AmazingFeature) - Abre un Pull Request
๐ Sรญgueme en Mis Redes Sociales
Si te ha gustado este proyecto y quieres ver mรกs contenido como este, no olvides suscribirte a mi canal de YouTube y seguirme en mis redes sociales: