MCP Server Template

@iranimij/magento-mcp-remote-server

Um servidor remoto do Model Context Protocol (MCP) para integração com o módulo do servidor MCP do Magento 2. Esta biblioteca fornece um servidor CLI que expõe ferramentas para demonstração e para buscar detalhes de produtos de um backend Magento. Ela é destinada a ser usada em conjunto com o módulo Magento 2 para habilitar recursos de IA e automação remota para sua loja Magento.

Instalação

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

Ou, para desenvolvimento local:

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

Uso

Adicione o seguinte às suas configurações de MCP do 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

Ou, se estiver executando localmente após a compilação:

node dist/bundle.cjs

Variáveis de Ambiente

• MAGENTO_API_URL (obrigatório): A URL base da sua API Magento (por exemplo, https://your-magento-site.com).
• (Opcional) Você pode adicionar cabeçalhos de autenticação em index.ts se a sua API Magento exigir um token.

---

Ferramentas

Este servidor expõe as seguintes ferramentas. Clique em cada ferramenta para documentação detalhada:

• get-product-details: Busca detalhes do produto para um determinado ID de produto na API Magento.
• get-todays-orders: Busca todos os pedidos feitos hoje na API Magento.
• create-customer: Cria um novo cliente no Magento.
• create-simple-product: Cria um novo produto simples no Magento.
• search-product-details: Busca detalhes do produto por SKU, nome ou ID na API Magento.

---

Exemplo de Saída

Abaixo está um exemplo de saída para uma busca de produto usando a ferramenta search-product-details:

---

Desenvolvimento

• Escrito em TypeScript. Código-fonte em src/.
• Facilmente extensível com ferramentas personalizadas.