MCP Server Template

Una plantilla inicial para construir un servidor del Protocolo de Contexto de Modelo (MCP) usando TypeScript y Node.js.

Documentación

@iranimij/magento-mcp-remote-server

Un servidor remoto de Protocolo de Contexto de Modelo (MCP) para integrarse con el módulo de servidor MCP de Magento 2. Esta biblioteca proporciona un servidor CLI que expone herramientas para demostración y para obtener detalles de productos de un backend de Magento. Está diseñado para usarse junto con el módulo de Magento 2 para habilitar funciones de IA y automatización remota para tu tienda Magento.

Instalación

npm install -g @iranimij/magento-mcp-remote-server

O, para desarrollo local:

git clone <this-repo-url>
cd mcp
npm install
npm run build && npm run bundle

Uso

Añade lo siguiente a la configuración de MCP de tu cursor:

"testServer": {
  "command": "npx",
  "args": ["@iranimij/magento-mcp-remote-server"],
  "env": {
    "MAGENTO_API_URL": "https://app.magento.test/",
    "MAGENTO_ADMIN_USERNAME": "admin",
    "MAGENTO_ADMIN_PASSWORD": "admin1234"
  }
},

Como CLI

npx magento-mcp-remote-server

O, si se ejecuta localmente después de la compilación:

node dist/bundle.cjs

Variables de Entorno

MAGENTO_API_URL (obligatorio): La URL base de tu API de Magento (p. ej., https://your-magento-site.com).
(Opcional) Puedes añadir cabeceras de autenticación en index.ts si tu API de Magento requiere un token.

Herramientas

Este servidor expone las siguientes herramientas. Haz clic en cada herramienta para obtener documentación detallada:

get-product-details: Obtén los detalles de un producto para un ID de producto dado desde la API de Magento.
get-todays-orders: Obtén todos los pedidos realizados hoy desde la API de Magento.
create-customer: Crea un nuevo cliente en Magento.
create-simple-product: Crea un nuevo producto simple en Magento.
search-product-details: Busca detalles de productos por SKU, nombre o ID desde la API de Magento.

Ejemplo de Salida

A continuación se muestra un ejemplo de salida para una búsqueda de productos usando la herramienta search-product-details:

Desarrollo

Escrito en TypeScript. Código fuente en src/.
Fácilmente extensible con herramientas personalizadas.