CommerceHub MCP

Plataforma de E-commerce con IA | AI-Powered E-commerce Platform

Conecta agentes de IA con tus tiendas online. Gestiona productos, ordenes, inventario, clientes y analytics desde una sola interfaz conversacional.

English | Instalacion | Guia Rapida | Herramientas | Documentacion

Que es CommerceHub MCP?

CommerceHub es un servidor MCP (Model Context Protocol) que permite a agentes de IA gestionar operaciones de e-commerce en multiples plataformas simultaneamente.

En lugar de alternar entre dashboards de Shopify, WooCommerce, Stripe y MercadoLibre, simplemente habla con tu agente de IA:

"Muestrame las ventas de hoy comparadas con ayer"

"Que productos necesito reabastecer esta semana?"

"Sincroniza el catalogo de Shopify a WooCommerce"

"Procesa el reembolso de la orden #1234 porque el cliente recibio el producto danado"

Related MCP server: Commerce-MCP

Planes y precios

Comprar Pro - $45.000 CLP/mes | Comprar Business - $185.000 CLP/mes | Pro Lifetime - $275.000 CLP

Plataformas soportadas

Clientes de IA compatibles

CommerceHub usa el protocolo MCP estandar (stdio), por lo que es compatible con cualquier cliente que soporte Model Context Protocol.

Arquitectura

  +----------+  +----------+  +----------+  +----------+
  |  Claude  |  | ChatGPT  |  |  Gemini  |  |  Cursor  |  ...
  | Desktop  |  | Open Web |  |  Studio  |  |   IDE    |
  +----+-----+  +----+-----+  +----+-----+  +----+-----+
       |              |              |              |
       +--------------+--------------+--------------+
                             |
                      MCP Protocol (stdio)
                             |
                    +--------+---------+
                    |   CommerceHub    |
                    |   MCP Server     |
                    +--------+---------+
                             |
         +-------------------+-------------------+
         |              |              |              |
   +-----+----+  +-----+----+  +------+-----+  +-----+------+
   |  Shopify |  |   Woo    |  |   Stripe   |  | MercadoLibre|
   |  Admin   |  | Commerce |  |    API     |  |    API      |
   +----------+  +----------+  +------------+  +-------------+

Instalacion

Requisitos previos

• Node.js 20 o superior

• npm 9 o superior

• Credenciales de al menos una plataforma (Shopify, WooCommerce, Stripe o MercadoLibre)

1. Clonar e instalar

git clone https://github.com/tu-usuario/commercehub-mcp.git
cd commercehub-mcp
npm install
npm run build

2. Configurar credenciales

cp .env.example .env
# Edita .env con tus credenciales

3. Conectar con tu cliente de IA

CommerceHub es compatible con todos los clientes MCP:

Agrega a tu claude_desktop_config.json:

{
  "mcpServers": {
    "commercehub": {
      "command": "node",
      "args": ["/ruta/a/commercehub-mcp/dist/index.js"],
      "env": {
        "SHOPIFY_STORE_URL": "https://tu-tienda.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxx"
      }
    }
  }
}

claude mcp add commercehub node /ruta/a/commercehub-mcp/dist/index.js

Open WebUI soporta MCP servers. Configura en Settings > Tools > MCP:

{
  "mcpServers": {
    "commercehub": {
      "command": "node",
      "args": ["/ruta/a/commercehub-mcp/dist/index.js"]
    }
  }
}

Agrega a .cursor/mcp.json en tu proyecto:

{
  "mcpServers": {
    "commercehub": {
      "command": "node",
      "args": ["/ruta/a/commercehub-mcp/dist/index.js"]
    }
  }
}

Agrega a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "commercehub": {
      "command": "node",
      "args": ["/ruta/a/commercehub-mcp/dist/index.js"]
    }
  }
}

Agrega a ~/.continue/config.yaml:

mcpServers:
  - name: commercehub
    command: node
    args:
      - /ruta/a/commercehub-mcp/dist/index.js

En VS Code, abre Cline Settings > MCP Servers > Add:

{
  "commercehub": {
    "command": "node",
    "args": ["/ruta/a/commercehub-mcp/dist/index.js"]
  }
}

Google AI Studio soporta MCP. Configura el server en la seccion de Tools:

{
  "mcpServers": {
    "commercehub": {
      "command": "node",
      "args": ["/ruta/a/commercehub-mcp/dist/index.js"]
    }
  }
}

Guia Rapida

Una vez conectado, prueba estos comandos:

"Lista mis productos de Shopify"
"Muestrame las ordenes pendientes de enviar"
"Cual es el revenue de esta semana?"
"Que productos tienen stock bajo?"
"Dame un reporte ejecutivo del dia"

Herramientas

CommerceHub incluye 37 herramientas organizadas en 5 categorias:

Productos (9 herramientas)

Ordenes (8 herramientas)

Inventario (6 herramientas)

Clientes (6 herramientas)

Analytics (8 herramientas)

Recursos MCP (3)

Prompts Predefinidos (3)

Caracteristicas Tecnicas

• Multi-plataforma: Conecta simultaneamente a Shopify, WooCommerce, Stripe y MercadoLibre

• Cache inteligente: Cache LRU con TTL configurable para respuestas rapidas

• Rate limiting: Respeta los limites de cada API automaticamente

• Retry automatico: Reintentos con backoff exponencial para resiliencia

• Validacion estricta: Todos los inputs validados con Zod

• TypeScript strict: Tipado completo sin any

• Logs estructurados: Logging JSON con pino para observabilidad

• Extensible: Patron adaptador para agregar proveedores facilmente

Stack Tecnologico

Agregar un nuevo proveedor

CommerceHub usa el patron adaptador. Para agregar un nuevo proveedor:

1. Crea una carpeta en src/providers/tu-proveedor/

2. Implementa la clase extendiendo BaseProvider

3. Implementa el mapper para traducir datos

4. Registra el proveedor en server.ts

// src/providers/amazon/amazon.provider.ts
import { BaseProvider } from '../base.provider.js';

export class AmazonProvider extends BaseProvider {
  readonly name = 'amazon' as const;

  protected buildUrl(path: string): string {
    return `https://sellingpartnerapi.amazon.com${path}`;
  }

  protected buildHeaders(): Record<string, string> {
    return { Authorization: `Bearer ${this.config.accessToken}` };
  }

  // Implementar metodos...
}

Consulta docs/PROVIDERS.md para la guia completa.

Documentacion

Contribuir

1. Fork el repositorio

2. Crea tu rama: git checkout -b feature/mi-feature

3. Commit: git commit -m 'Agrega mi feature'

4. Push: git push origin feature/mi-feature

5. Crea un Pull Request

Licencia

MIT License - ver LICENSE para detalles.

English

CommerceHub MCP is an AI-powered e-commerce operations platform built on the Model Context Protocol (MCP). It connects AI agents with multiple e-commerce platforms (Shopify, WooCommerce, Stripe, MercadoLibre) through 37 tools for managing products, orders, inventory, customers, and analytics from a single conversational interface.

Key Features

• 37 MCP Tools across 5 categories (Products, Orders, Inventory, Customers, Analytics)

• 4 Platform Integrations (Shopify, WooCommerce, Stripe, MercadoLibre)

• 8 AI Client Compatible: Claude, ChatGPT (Open WebUI), Gemini, Cursor, Windsurf, Continue.dev, Cline

• 3 Real-time Resources (Store Info, Recent Orders, Inventory Alerts)

• 3 Pre-built Prompts (Daily Report, Order Summary, Inventory Check)

• Enterprise Features: Smart caching, rate limiting, automatic retries, structured logging

• TypeScript Strict Mode with full Zod validation

• Extensible Architecture: Adapter pattern for easy provider addition

Quick Start

npm install commercehub-mcp

{
  "mcpServers": {
    "commercehub": {
      "command": "npx",
      "args": ["commercehub-mcp"],
      "env": {
        "SHOPIFY_STORE_URL": "https://your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxx"
      }
    }
  }
}

Built by Ricardo Sepúlveda

TypeScript + Model Context Protocol