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 • Equip 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?

Juga una estona abans de marxar

ELS NOSTRES SERVEIS

Com et podem ajudar

Intel·ligència artificial

Agents d'IA, chatbots i assistents intel·ligents que automatitzen tasques i atenen els teus clients 24/7 per millorar l'eficiència del teu negoci.

Més info

Desenvolupament de programari

Aplicacions web, mòbils i d'escriptori, intranets, e-commerce, SaaS i plataformes de gestió dissenyades per a les necessitats concretes de la teva empresa.

Més info

Serveis cloud

Migració, infraestructura, hosting gestionat, alta disponibilitat i seguretat en Microsoft Azure i Amazon Web Services perquè el teu negoci escali sense límits.

Més info

Ciberseguretat i pentesting

Auditories de seguretat, test d'intrusió (pentesting) i protecció d'aplicacions, dades i infraestructura on-premise i cloud, amb hacking ètic i compliment normatiu.

Més info

Business Intelligence

Quadres de comandament i anàlisi de dades amb Power BI: integrem les teves fonts, dissenyem dashboards i KPIs i convertim les teves dades en decisions.

Més info

Automatització de processos

Automatitzem tasques repetitives i connectem les teves aplicacions amb n8n, Power Automate, Make i RPA, eliminant treball manual i augmentant la productivitat.

Més info

Formació per a empreses

Formem els teus equips en tecnologia amb criteri: desenvolupament web, bases de dades, Git, bones pràctiques i seguretat, automatització amb n8n, intel·ligència artificial per a empreses i creació de solucions d'IA amb Azure AI Foundry.

Més info

Auditoria de codi

Auditem el codi que creguis tu, el teu equip o una IA: et diem què està bé i què millorar, el securitzem i el deixem llest per a producció, web o app.

Més info

Generació d'imatges amb IA

Creem per tu les imatges que necessita el teu negoci amb intel·ligència artificial: producte, xarxes, publicitat, il·lustració i avatars. Tu ens dius què vols i t'ho lliurem llest per fer servir.

Més info

Generació de vídeos amb IA

Creem per tu vídeos amb intel·ligència artificial: promocionals, per a xarxes, presentadors virtuals, doblatge i animacions. Ens comptes la idea i t'ho lliurem muntat i llest per publicar.

Més info

Avatars conversacionals amb IA

Creem avatars conversacionals amb IA —humans digitals amb cara i veu— que atenen els teus clients i equips amb el coneixement de la teva empresa, a la teva web, monitors interactius, WhatsApp o Teams.

Més info

Màrqueting Online i IA

Google Ads, Meta Ads, LinkedIn Ads i posicionament en motors d'IA (GEO/AEO): captem clients i fem que la teva marca aparegui on et busquen, també a ChatGPT, Gemini i Perplexity.

Més info

Tens un projecte en ment?

Explica'ns la teva visió i la convertim en una solució de programari. Sigui quin sigui l'abast, fem realitat la teva idea.

Live Chat