workshop-27-08-26

Ejemplo de servidor MCP para el workshop del bootcamp AWS AI FDE for Commerce del 27/08/2026

¿Qué es MCP?

El MCP (Model Context Protocol) es un protocolo open-source de comunicación entre sistemas, que permite el intercambio de información de datos/contexto entre diferentes aplicaciones (mayoritariamente de IA).

Usando este protocolo, es posible que un sistema de IA (como una aplicación de agentes) consuma/proporcione información contextual de/para otro sistema, permitiendo que los modelos operen con más certeza y relevancia.

Usando la analogía del USB-C:

Piensa en el MCP como un puerto USB-C para aplicaciones de IA. Así como el USB-C proporciona una manera estandarizada de conectar dispositivos electrónicos, el MCP proporciona una manera estándar de conectar aplicaciones de IA a otros sistemas.

Related MCP server: Basic MCP Server

Opciones de SDK

El protocolo admite diferentes opciones de SDKs (Software Development Kits), que pueden usarse para implementar MCP en diferentes lenguajes/frameworks.

Encuentra la lista completa aquí: Available SDKs

Opciones de Transporte

Centrándonos en el contexto del workshop, vamos a explorar las opciones de transporte más comunes/populares para Node.js:

stdio

Haz que el servidor MCP se ejecute como un proceso hijo, envía y recibe mensajes vía stdin y stdout.

Serve over stdio

HTTP

Proporciona un servidor que recibe y envía mensajes vía peticiones HTTP a diversos clientes simultáneamente.

Serve over HTTP

Frameworks

Usa tecnologías/frameworks de Node.js para facilitar la implementación del protocolo MCP, como:

• Express

• Fastify

• Hono

Escenario del Workshop

Cliente Nordesul

1. Considera un proyecto de e-commerce en un gran cliente, con un equipo de 20 desarrolladores asignados para realizar la migración de su tienda virtual heredada (V0) a un framework más moderno (V1). El objetivo es que la tienda virtual V1 sea idéntica a V0, pero use mejoras de rendimiento de V1.

2. Como diversos desarrolladores trabajarán en la misma base de código, es primordial que las entregas tengan la mejor estandarización y calidad posibles, siguiendo las normas e identidad de nuestra compañía.

3. El cliente dispone de una base de datos con documentación de todas sus APIs, que se encuentran en un endpoint compartido con el equipo de desarrollo para consulta.

Este Repositorio

Este repositorio contiene una plantilla de servidor MCP, que puede ser usada para:

• Entender la implementación de los transportes stdio y HTTP con @modelcontextprotocol/server;

• Simular la comunicación entre sistemas de IA y cualquier servicio externo;

• Servir como inspiración para la implementación de un servidor MCP real;

• Ser la puerta de entrada para el uso de Agentes de IA con herramientas personalizadas.

Estructura del Repositorio

/servers

Servidores MCP de ejemplo, usando diferentes transportes y frameworks.

• /servers/stdio

Sirve mensajes MCP vía stdin y stdout, como un proceso hijo.

• /servers/http

Sirve mensajes MCP vía peticiones HTTP, usando únicamente el módulo HTTP nativo de Node.js.

• /servers/express

Sirve mensajes MCP vía peticiones HTTP, usando el framework Express.

/tools

Ejemplos de herramientas personalizadas, que pueden ser usadas por Agentes de IA para interactuar con otros sistemas.

• /tools/index.js

Centraliza y exporta todas las herramientas del repositorio, para que los servidores MCP puedan registrarlas de forma unificada.

• /tools/nordesul-deploy

Devuelve cuidados y buenas prácticas esenciales para un despliegue seguro en el cliente Nordesul.

• /tools/nordesul-delivery

Simula patrones y contratos de implementación para el proyecto.

• /tools/nordesul-reference

Simula la consulta de una documentación de API en el cliente Nordesul.

• /tools/nordesul-status

Simula la consulta del estado de una aplicación en el cliente Nordesul.

/utils

Centraliza funciones utilitarias/compartidas del proyecto.

/.opencode

Directorio de configuración de Opencode, contiene un agente personalizado mentor, para ayudar a los participantes del workshop a entender el repositorio y sus funcionalidades.

Ejecutando el Proyecto

Prerrequisitos

• Git;

• Clonar el repositorio del workshop;

• Opencode (o cualquier otro agente de IA que soporte MCP) instalado y configurado;

• Node.js (>= LTS preferido)

• Gestor de Paquetes (npm o yarn)

Instalando las Dependencias

En la raíz del proyecto, ejecuta el comando:

npm install

# ou:

yarn install

Ejecutando los Servidores

Servidor MCP vía stdio:

npm run start:stdio

# ou:

yarn start:stdio

Servidor MCP vía http:

npm run start:http

# ou:

yarn start:http

Servidor MCP vía integración con Express:

npm run start:express

# ou:

yarn start:express

Ejecutando el Agente Mentor (Ejemplo con Opencode)

Con Opencode instalado, abre una terminal de tu preferencia en el directorio del repositorio y ejecuta el comando:

opencode

La primera ejecución descargará todas las dependencias de Opencode, así que espera la finalización del proceso. El agente Mentor ya estará seleccionado por defecto.

Integración de servidores MCP con Agentes de IA

• Opencode: MCP servers;

• Claude: Connect Claude Code to tools via MCP;

• Codex: Model Context Protocol;

• Cursor: Model Context Protocol (MCP);

• Antigravity: Model Context Protocol (MCP).

Prompts de Ejemplo

Algunos ejemplos para interactuar con las herramientas del repositorio, usando tu agente:

nordesul-delivery

Quais são os padrões de implementação para a área de checkout do Nordesul?

nordesul-deploy

Antes de eu publicar essa mudança no Nordesul, quais cuidados devo tomar?

nordesul-reference

Me mostra a documentação da API de pedidos (orders) do Nordesul.

nordesul-status

Qual o status atual da aplicação checkout-service no Nordesul?