`medusa-mcp`

Descripción general

medusa-mcp es un servidor de Protocolo de Contexto de Modelo (MCP) diseñado para la integración con el SDK de JavaScript de Medusa. Proporciona una capa de backend escalable para gestionar e interactuar con los modelos de datos de Medusa, lo que permite la automatización, la orquestación y las extensiones de servicios inteligentes.

🧩 ¿Qué es un servidor MCP?

Un servidor MCP es un backend modular y extensible que:

Permite la orquestación de servicios en tiempo real
Admite comunicación estandarizada y de alto rendimiento.
Actúa como un puente entre las herramientas de IA/automatización y los sistemas del mundo real.

Estos servidores se utilizan en áreas como IA, IoT y software empresarial para conectar diversos servicios y automatizar tareas utilizando protocolos estandarizados como JSON-RPC.

🔑 Características principales

Arquitectura modular : servicios componibles para mayor flexibilidad
Alta eficiencia : optimizada para velocidad y escala
Diseño extensible : agregue nuevas capacidades fácilmente
Implementación entre entornos : nube, local o híbrido
Interfaces preparadas para IA : integre LLM y herramientas sin problemas

🧠 Rol en los sistemas de IA

Los servidores MCP permiten a los agentes de IA:

Acceda a datos en tiempo real desde API, archivos o bases de datos
Automatizar procesos comerciales (por ejemplo, cumplimiento de pedidos, actualizaciones de precios)
Interactuar con servicios externos de forma segura y controlada

🚀 Medusa JS + MCP

Usando medusa-mcp , Medusa JS puede:

Automatizar flujos de trabajo (por ejemplo, ajustes de inventario o precios)
Conectarse con herramientas externas (correo electrónico, análisis, etc.)
Utilice agentes de IA para analizar tendencias y activar acciones
Habilitar una arquitectura escalable y modular para plataformas de comercio

✨ Características

✅ Compatibilidad con el Protocolo de Contexto de Modelo (MCP)
📈 Infraestructura escalable
🧱 Arquitectura de complementos extensible
🔗 Integrado con Medusa JS SDK

🛠️ Instalación

Clonar el repositorio e instalar las dependencias:

npm install

Construir el proyecto:

npm run build

▶️ Uso

Iniciar el servidor:

npm start

Prueba usando el Inspector MCP:

npx @modelcontextprotocol/inspector ./dist/index.js

Nota: reinicie el Inspector y su navegador después de cada reconstrucción.

🌍 Variables de entorno

Variable	Descripción
`MEDUSA_BACKEND_URL`	Su URL de backend de Medusa
`PUBLISHABLE_KEY`	Su clave API publicable de Medusa
`MEDUSA_USERNAME`	Nombre de usuario de administrador de Medusa (para administrador)
`MEDUSA_PASSWORD`	Contraseña de administrador de Medusa (para administrador)

El servidor se ejecuta en: http://localhost:3000

Diagrama de arquitectura

Así es como el servidor medusa-mcp encaja en una configuración típica con Medusa JS y sistemas externos:

       +-------------------------+
       |     AI Assistant /      |
       |     LLM / Automation    |
       +-----------+-------------+
                   |
                   v
    +--------------+--------------+
    |     MCP Server (medusa-mcp) |
    |-----------------------------|
    | - JSON-RPC Communication    |
    | - AI-Ready Interface        |
    | - Plugin Support            |
    +------+----------------------+
                   |                             
                   +
                   |                                                         
                   v                                                         
         +-------------------+
         | Medusa Backend    |
         | (Products, Orders)|
         +-------------------+
                   |
                   |
                   v
           +--------------+
           | Medusa Store |
           | Frontend     |
           +--------------+
                   |
                   |
                   v
      +-------------------------+
      | External Services / API |
      | (e.g., Payments, Email) |
      +-------------------------+

🧪 Personalización

Para adaptar el servidor a su configuración de Medusa:

Reemplace admin.json y store.json con sus propias definiciones de OAS para un control detallado.

Reemplace los esquemas OpenAPI en la carpeta oas/ :
- admin.json – Puntos finales de administración
- store.json – Puntos finales de la tienda

Utilice @medusajs/medusa-oas-cli para regenerar estos archivos.

También puedes bifurcar este proyecto para crear tu propia integración personalizada de Medusa impulsada por MCP.

🤝 Contribuyendo

¡Agradecemos sus contribuciones! Consulte nuestra guía CONTRIBUTING.md .

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.

Medusa MCP Server

Integrations