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 read • Q2BSTUDIO Team

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.

A BREAK?

Play for a moment before you go

OUR SERVICES

How we can help you

Artificial intelligence

AI agents, chatbots, and intelligent assistants that automate tasks and serve your customers 24/7 to improve the efficiency of your business.

More info

Software Development

Web, mobile, and desktop applications, intranets, e-commerce, SaaS, and management platforms designed for your company's specific needs.

More info

Cloud services

Migration, infrastructure, managed hosting, high availability, and security on Microsoft Azure and Amazon Web Services to help your business scale without limits.

More info

Cybersecurity and pentesting

Security audits, penetration testing and protection of applications, data and infrastructure on-premise and cloud, with ethical hacking and regulatory compliance.

More info

Business Intelligence

Dashboards and data analysis with Power BI: we integrate your sources, design dashboards and KPIs and turn your data into decisions.

More info

Process automation

We automate repetitive tasks and connect your applications with n8n, Power Automate, Make, and RPA, eliminating manual work and increasing productivity.

More info

Training for Companies

We train your teams in technology with criteria: web development, databases, Git, best practices and security, automation with n8n, artificial intelligence for companies and creation of AI solutions with Azure AI Foundry.

More info

Code Auditing

We audit the code that you, your team or an AI create: we tell you what is good and what to improve, we secure it and make it ready for production, web or app.

More info

AI Image Generation

We create for you the images that your business needs with artificial intelligence: product, networks, advertising, illustration and avatars. You tell us what you want and we deliver it ready to use.

More info

AI Video Generation

We create videos with artificial intelligence for you: promotional, networking, virtual presenters, dubbing and animations. You tell us the idea and we will deliver it assembled and ready to publish.

More info

AI Conversational Avatars

We create conversational avatars with AI – digital humans with a face and voice – that serve your customers and teams with the knowledge of your company, on your website, interactive monitors, WhatsApp or Teams.

More info

Online Marketing and AI

Google Ads, Meta Ads, LinkedIn Ads and AI Engine Positioning (GEO/AEO): we attract customers and make your brand appear where they search for you, also on ChatGPT, Gemini and Perplexity.

More info

Do you have a project in mind?

Tell us your vision and we'll turn it into a software solution. Whatever the scope, we make your idea real.

Live Chat