AI Conversational Bot MCP

1. De que se trata el proyecto

Este proyecto es un servidor MCP para gestion de ordenes, desarrollado con Node.js, TypeScript, Express y el SDK de Model Context Protocol.

Su objetivo es exponer herramientas MCP que pueden ser consumidas por un agente conversacional para consultar y crear ordenes. El servidor publica un endpoint MCP en /mcp y un endpoint de salud en /health.

Herramientas disponibles:

• get_order: obtiene la informacion completa de una orden.

• get_order_status: obtiene solo el estado actual de una orden.

• create_order: crea una nueva orden para un cliente.

Actualmente el servicio de ordenes usa datos simulados en src/services/order.service.ts, por lo que no depende todavia de una base de datos o API externa real.

Related MCP server: mcp-coffee

2. Como se ejecuta

Instala las dependencias:

npm install

Crea un archivo .env tomando como base .env.example:

PORT=3002

Ejecuta el proyecto en modo desarrollo:

npm run dev

Tambien puedes ejecutarlo sin modo watch:

npm start

Para compilar TypeScript:

npm run build

Para ejecutar la version compilada:

npm run start:compiled

Para inspeccionar el servidor MCP con el inspector oficial:

npm run inspector

3. Que hay que tener en cuenta para ejecutarlo

• El proyecto requiere Node.js >=20.

• Se recomienda usar la version indicada en .nvmrc.

• El archivo .env debe existir antes de iniciar el proyecto.

• La variable PORT es opcional. Si no se define, el servidor usa el puerto 3002.

• El endpoint MCP queda disponible en http://localhost:3002/mcp cuando se usa el puerto por defecto.

• El endpoint de salud queda disponible en GET http://localhost:3002/health.

• Por defecto, el servidor permite hosts locales mediante MCP_ALLOWED_HOSTS con localhost y 127.0.0.1.

• Las respuestas de ordenes son simuladas; para usar datos reales hay que reemplazar la logica de src/services/order.service.ts.

Endpoints principales:

• ALL /mcp: punto de entrada para clientes MCP.

• GET /health: valida que el servidor esta activo.