Laboratorio MCP — Integración con Claude Desktop

Descripción

Este laboratorio implementa una integración completa del Model Context Protocol (MCP), conectando múltiples microservicios (ventas y pedidos) a través de un gateway central.
El sistema permite que Claude Desktop invoque herramientas MCP locales mediante comunicación STDIO.

Related MCP server: atiendo24-mcp-server

Estructura del proyecto

packages/
├─ mcp-ventas-node/     → Servidor Node.js que maneja operaciones de ventas
├─ mcp-pedidos-py/      → Servidor Python que gestiona pedidos
└─ mcp-gateway/         → Gateway que expone ambos servicios como un único MCP

Pasos de ejecución

Iniciar la base de datos

Ejecuta el contenedor PostgreSQL:

docker compose up -d

Esto levanta una instancia con las credenciales

Host: localhost
Puerto: 5433
Usuario: postgres
Contraseña: postgres
Base de datos: mcp_lab

Ejecutar los servidores de negocio

Servidor de pedidos (Python)

cd packages/mcp-pedidos-py
source .venv/bin/activate
python3 server.py

Servidor ventas (Node.js)

cd packages/mcp-ventas-node
npm run build
node dist/server.js

Gateway MCP

Este gateway conecta ambos microservicios el ecosistema MCP

cd packages/mcp-gateway
chmod +x run-gateway.sh
./run-gateway.sh

Debería salir un mensaje como este

[ventas] DB mode=postgres
[pedidos] INFO DB mode=postgres

Integración con Claude Desktoop

Crea o edita el archivo

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Debería salir un mensaje como este

{
  "mcpServers": {
    "mcp-gateway": {
      "command": "/TuDireccion/Laboratorio MCP/packages/mcp-gateway/run-gateway.sh",
      "args": []
    }
  }
}

Nota: para la implementación en MAC se le debe dar permisos a Claude Desktop para acceder al disco

Claude Desktop