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
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)
