Construye un servidor MCP en JavaScript para Claude y Codex

Aprende a construir un servidor MCP mínimo en JavaScript para que los modelos de IA ejecuten funciones reales. Guía práctica con ejemplo de GitHub Stats. ¡Pruébalo ya!

12 jun 2026 • 4 min de lectura • Equipo Q2BSTUDIO

Implementa un servidor MCP funcional en minutos

La interacción entre modelos de lenguaje y sistemas externos ha dado un salto cualitativo gracias al Model Context Protocol (MCP). Este estándar, promovido por Anthropic, permite que asistentes como Claude, Codex o cualquier LLM invoquen herramientas reales —consultar bases de datos, ejecutar comandos, acceder a APIs— sin recurrir a alucinaciones ni respuestas inventadas. En este artículo exploramos cómo construir un servidor MCP en JavaScript, listo para conectarse con Claude Desktop y Codex, y cómo aplicaciones a medida pueden beneficiarse de esta arquitectura.

El MCP funciona como un puente: el modelo de lenguaje pide una acción (por ejemplo, “obtén las estadísticas de un repositorio de GitHub”) y el servidor MCP la ejecuta, devolviendo datos reales. Esto transforma a los agentes IA de simples generadores de texto en asistentes operativos. Para las empresas que desarrollan software a medida, integrar MCP significa dotar a sus chatbots o asistentes de capacidades ejecutivas sin exponer lógica interna ni reinventar la rueda.

Construir un servidor MCP básico con Node.js requiere solo unos pocos componentes: un servidor que registre herramientas (tools), un validador de parámetros (Zod es la opción recomendada) y un transporte —stdio para entornos locales o HTTP para despliegues en la nube. El SDK oficial de MCP (en su versión para JavaScript/ESM) simplifica todo el protocolo de handshake, listado de herramientas y ejecución. La clave está en que cada herramienta se define como una función asíncrona que recibe parámetros tipados y devuelve contenido estructurado (texto, imágenes, tablas).

Un ejemplo práctico: un servidor que consulta estadísticas de un repositorio de GitHub. Se define la herramienta get-repo-stats con los parámetros owner y repo. Al ser invocada, hace una petición fetch a la API de GitHub y devuelve un texto con estrellas, forks y issues abiertos. Esta misma lógica puede extenderse a cualquier API: métricas de ventas, estado de servidores, datos de Power BI, etc. La versatilidad es enorme, especialmente cuando combinamos MCP con ia para empresas desarrollada por Q2BSTUDIO.

Desde el punto de vista del despliegue, el transporte más sencillo para pruebas locales es stdio: el servidor se ejecuta como un proceso hijo que se comunica por stdin/stdout. Claude Desktop lo soporta de forma nativa: solo hay que agregar la ruta absoluta del script en el archivo de configuración (claude_desktop_config.json). Para Codex, se utiliza un adaptador similar: se añade el servidor MCP mediante la CLI de Codex o editando el archivo config.toml. En ambos casos, el asistente empieza a ofrecer la herramienta como una función disponible.

Cuando se necesita escalar o exponer el servidor a múltiples clientes, el transporte HTTP (StreamableHTTP) es la opción recomendada. Aquí entran en juego los servicios cloud aws y azure, que proporcionan entornos seguros y escalables para alojar estos servidores. Q2BSTUDIO ofrece soluciones de infraestructura y ciberseguridad para garantizar que las conexiones entre modelos y herramientas sean robustas, autenticadas y con cifrado TLS. No hay que olvidar que exponer un servidor MCP a Internet implica gestionar claves API, limitar tiempos de espera y proteger contra accesos no autorizados.

La integración con agentes IA no se limita a consultas simples. Gracias a MCP, podemos construir flujos complejos: un asistente que primero obtiene datos de un repositorio, luego los procesa con Power BI y finalmente genera un informe ejecutivo. Esto es posible combinando varias herramientas dentro del mismo servidor o encadenando múltiples servidores MCP. Las empresas que desarrollan software a medida pueden crear sus propios ecosistemas de herramientas, adaptadas a sus procesos de negocio.

Durante la puesta en marcha, es común encontrarse con problemas de importación (ESM, extensión .js en los imports, advertencia MODULE_TYPELESS_PACKAGE_JSON). La solución estándar es añadir 'type': 'module' en el package.json y usar rutas explícitas como @modelcontextprotocol/sdk/server/mcp.js. También es útil ejecutar con node --trace-warnings para depurar la resolución de módulos. Para entornos de producción, Q2BSTUDIO recomienda empaquetar el servidor como un contenedor Docker o una función serverless, y aprovechar servicios inteligencia de negocio para monitorizar su uso.

En resumen, crear un servidor MCP en JavaScript para Claude y Codex es un paso estratégico para cualquier organización que quiera convertir sus asistentes de inteligencia artificial en herramientas operativas reales. Ya sea para consultar datos internos, automatizar tareas o enriquecer informes con Power BI, MCP abre un nuevo nivel de integración. En Q2BSTUDIO, como empresa de desarrollo de software y tecnología, acompañamos a nuestros clientes en todo el ciclo: desde el diseño de la arquitectura hasta el despliegue seguro en la nube, pasando por las aplicaciones a medida que conectan modelos de lenguaje con su negocio.

¿UNA PAUSA?

Juega un momento antes de irte

NUESTROS SERVICIOS

Cómo podemos ayudarte

Inteligencia artificial

Agentes de IA, chatbots y asistentes inteligentes que automatizan tareas y atienden a tus clientes 24/7 para mejorar la eficiencia de tu negocio.

Más info

Desarrollo de software

Aplicaciones web, móviles y de escritorio, intranets, e-commerce, SaaS y plataformas de gestión diseñadas para las necesidades concretas de tu empresa.

Más info

Servicios cloud

Migración, infraestructura, hosting gestionado, alta disponibilidad y seguridad en Microsoft Azure y Amazon Web Services para que tu negocio escale sin límites.

Más info

Ciberseguridad y pentesting

Auditorías de seguridad, test de intrusión (pentesting) y protección de aplicaciones, datos e infraestructura on-premise y cloud, con hacking ético y cumplimiento normativo.

Más info

Business Intelligence

Cuadros de mando y análisis de datos con Power BI: integramos tus fuentes, diseñamos dashboards y KPIs y convertimos tus datos en decisiones.

Más info

Automatización de procesos

Automatizamos tareas repetitivas y conectamos tus aplicaciones con n8n, Power Automate, Make y RPA, eliminando trabajo manual y aumentando la productividad.

Más info

Formación para empresas

Formamos a tus equipos en tecnología con criterio: desarrollo web, bases de datos, Git, buenas prácticas y seguridad, automatización con n8n, inteligencia artificial para empresas y creación de soluciones de IA con Azure AI Foundry.

Más info

Auditoría de código

Auditamos el código que creas tú, tu equipo o una IA: te decimos qué está bien y qué mejorar, lo securizamos y lo dejamos listo para producción, web o app.

Más info

Generación de imágenes con IA

Creamos por ti las imágenes que necesita tu negocio con inteligencia artificial: producto, redes, publicidad, ilustración y avatares. Tú nos dices qué quieres y te lo entregamos listo para usar.

Más info

Generación de vídeos con IA

Creamos por ti vídeos con inteligencia artificial: promocionales, para redes, presentadores virtuales, doblaje y animaciones. Nos cuentas la idea y te lo entregamos montado y listo para publicar.

Más info

Avatares conversacionales con IA

Creamos avatares conversacionales con IA —humanos digitales con cara y voz— que atienden a tus clientes y equipos con el conocimiento de tu empresa, en tu web, monitores interactivos, WhatsApp o Teams.

Más info

Marketing Online e IA

Google Ads, Meta Ads, LinkedIn Ads y posicionamiento en motores de IA (GEO/AEO): captamos clientes y hacemos que tu marca aparezca donde te buscan, también en ChatGPT, Gemini y Perplexity.

Más info

¿Tienes un proyecto en mente?

Cuéntanos tu visión y la convertimos en una solución de software. Sea cual sea el alcance, hacemos realidad tu idea.

Live Chat