Bun MCP Server Workshop

🧠 Construyendo un servidor MCP en tiempo real con JavaScript y VS Code

Este repositorio acompaña al taller “Construyendo un servidor MCP en tiempo real con JavaScript y VS Code”, impartido por David Fernández Perrino (Innusual Tech Services SL). Durante la sesión aprenderás a crear, ejecutar e integrar un servidor Model Context Protocol (MCP) con herramientas modernas de desarrollo.

🚀 Objetivos del taller

• Crear un servidor MCP funcional con Node.js y Express.
• Implementar comunicación en tiempo real mediante HTTP streaming.
• Integrar el servidor con VS Code para un flujo de desarrollo ágil.
• Aplicar mejores prácticas de seguridad y arquitectura en entornos MCP.

🧩 ¿Qué es MCP?

Model Context Protocol (MCP) es un estándar que permite que aplicaciones de inteligencia artificial interactúen con recursos externos (archivos, bases de datos, APIs, etc.) de forma estructurada, segura y en tiempo real. Facilita la comunicación bidireccional entre agentes IA y servidores mediante transporte HTTP o STDIO, habilitando flujos de trabajo más integrados y seguros.

🧰 Requisitos previos

Antes de comenzar, asegúrate de tener instalado:

• Node.js LTS (v22 o superior) →
• VS Code → https://code.visualstudio.com
• bun (opcional, usado en el taller) → https://bun.com
• Git para clonar el repositorio de ejemplo

💻 Instalación y ejecución

# Clona este repositorio
git clone https://github.com/dfperrino/bun-mcp-server-workshop.git
cd bun-mcp-server-workshop

# Instala dependencias
bun install
# o, si prefieres npm
npm install

# Ejecuta el servidor MCP
bun run start
# o
npm run start

El servidor se ejecutará por defecto en http://localhost:3000.

🔗 Integración con VS Code

1. Abre VS Code y ve a la configuración (settings.json).
2. Define la URL del servidor local:

   "mcp.server.url": "http://localhost:3000"

1. Añade tu token de autenticación en los headers (si aplica).
2. Desde VS Code podrás descubrir y explorar los recursos expuestos por el servidor MCP directamente desde el editor.

☁️ Despliegue rápido (Azure / Docker)

docker build -t mcp-server .
docker run -p 3000:3000 mcp-server

Para despliegues en Azure App Service:

• Crea una Web App desde container.
• Configura variables de entorno.
• Habilita logs y Application Insights.

🔒 Mejores prácticas

• Usa HTTPS en producción.
• Implementa rate limiting y validación de inputs.
• Rota tokens y audita permisos con regularidad.
• Evita exponer información sensible en logs.

📚 Recursos recomendados

• Documentación oficial de MCP
• Server-Sent Events en MDN
• MCP HTTP Streaming
• VS Code

🙌 Autor

David Fernández Perrino CoFundador & Tech Manager en Innusual Tech Services SL 📧 dferper@innusual.es 🔗 LinkedIn