Commerce MCP Server

Servidor MCP demonstrativo para operacoes de e-commerce: catalogo, pedidos e integracoes com plataformas de loja.

Este e um repo publico sanitizado. Ele nasceu da necessidade de operar e-commerce com ferramentas externas sem expor credenciais, tokens de loja ou dados de cliente.

O que este projeto demonstra

• Arquitetura de adapter para APIs de e-commerce.

• Contratos de tools pensados para agentes/automacoes.

• Validacao centralizada de ambiente.

• Testes em regras de catalogo.

• Cuidado com limites entre codigo publico e credenciais privadas.

Related MCP server: Maple Cart MCP

Tools previstas

• searchProducts: busca produtos por termo, status e estoque.

• getProduct: consulta SKU/produto por identificador.

• updatePrice: atualiza preco com validacao.

• createOrderNote: registra observacao operacional em pedido.

Rodando

npm install
npm test
npm run build

Seguranca

• Use .env.example como referencia.

• Nunca versionar .env.

• Tokens de loja devem ser revogados antes de abrir qualquer repo antigo.

• Logs devem mascarar Authorization, cookies e payloads de cliente.