MCP Server - Tienda de Suplementos Deportivos

Servidor MCP (Model Context Protocol) que conecta un LLM con una base de datos PostgreSQL de e-commerce. Permite a agentes de IA buscar productos, consultar pedidos, gestionar clientes y crear órdenes a través de herramientas estructuradas.

┌──────────────┐    Streamable HTTP    ┌──────────────┐       SQL       ┌────────────┐
│  LLM Client  │◄─────────────────────►│  MCP Server  │◄───────────────►│ PostgreSQL │
│  (Claude,    │     JSON-RPC 2.0      │  :9333/mcp   │                 │   :7667    │
│   GPT, etc.) │                       └──────────────┘                 └────────────┘
└──────────────┘

Inicio Rápido

Requisitos previos

• Node.js 18+
• Docker y Docker Compose

1. Clonar e instalar

git clone https://github.com/sebastiancastillorock/mcpserverecommerce.git
cd mcpserverecommerce
npm install

2. Configurar variables de entorno

cp .env.example .env

El archivo .env contiene:

MCP_HOST=0.0.0.0
MCP_PORT=9333
DATABASE_URL=postgresql://mcp_readonly:mcp_readonly_2024@localhost:7667/suplementos_db
DATABASE_ORDERS_URL=postgresql://mcp_orders:mcp_orders_2024@localhost:7667/suplementos_db

3. Levantar la base de datos

docker compose up -d

Esto crea la base de datos PostgreSQL con el esquema y datos de ejemplo automáticamente.

4. Iniciar el servidor

# Desarrollo (hot reload)
npm run dev

# Producción
npm run build && npm start

El servidor estará disponible en http://localhost:9333/mcp.

Conectar tu propia base de datos

Si quieres usar este servidor con tu propia base de datos PostgreSQL (en lugar de la incluida con Docker), sigue estos pasos:

Opción A: Apuntar a una base de datos existente

Solo necesitas modificar las variables de entorno en .env:

# Conexión de solo lectura (consultas)
DATABASE_URL=postgresql://USUARIO:PASSWORD@HOST:PUERTO/NOMBRE_DB

# Conexión de escritura (crear pedidos y clientes)
DATABASE_ORDERS_URL=postgresql://USUARIO_ESCRITURA:PASSWORD@HOST:PUERTO/NOMBRE_DB

Ejemplos:

# PostgreSQL local
DATABASE_URL=postgresql://mi_usuario:mi_password@localhost:5432/mi_tienda

# Servidor remoto
DATABASE_URL=postgresql://admin:secreto@db.miservidor.com:5432/ecommerce

# Servicios cloud (Supabase, Neon, Railway, etc.)
DATABASE_URL=postgresql://user:pass@db.xxxx.supabase.co:5432/postgres

Opción B: Crear el esquema en tu base de datos

Si tu base de datos está vacía, ejecuta los scripts SQL incluidos para crear las tablas necesarias:

# Conectar a tu PostgreSQL y ejecutar el esquema
psql -h HOST -U USUARIO -d NOMBRE_DB -f init-db/01-schema.sql

# (Opcional) Cargar datos de ejemplo
psql -h HOST -U USUARIO -d NOMBRE_DB -f init-db/02-seed-data.sql

Opción C: Adaptar el esquema a tu base de datos existente

Si ya tienes una base de datos con estructura diferente, necesitas modificar las queries SQL en src/index.ts. El servidor espera estas tablas:

-- Tabla de productos (catálogo)
productos (id, nombre, descripcion, precio, stock, categoria, ingredientes, marca)

-- Tabla de clientes
clientes (id, nombre, email, telefono, direccion)

-- Tabla de pedidos
pedidos (id, numero_pedido, cliente_id, estado, fecha_pedido, total, direccion_envio, notas)

-- Detalle de cada pedido
detalle_pedidos (id, pedido_id, producto_id, cantidad, precio_unitario)

Si tus tablas tienen otros nombres o columnas, busca las queries SELECT, INSERT y UPDATE en src/index.ts y src/db.ts y adáptalas a tu esquema.

Usuarios de base de datos recomendados

Para mayor seguridad, se recomienda crear dos usuarios con permisos separados:

-- Usuario de solo lectura (para consultas)
CREATE USER mcp_readonly WITH PASSWORD 'tu_password_seguro';
GRANT CONNECT ON DATABASE tu_db TO mcp_readonly;
GRANT USAGE ON SCHEMA public TO mcp_readonl

... [View full README on GitHub](https://github.com/sebastiancastillorock/mcpserverecommerce#readme)