mcp-maximatech-dw

MCP Server com o dicionário completo do Data Warehouse da MáximaTech v2.8.

Cobre todos os módulos: MaxGestão, maxMotorista e maxPesquisa.

Estrutura do DW

| Tipo | Quantidade | |------|-----------| | Fatos | 30 | | Dimensões | 42 | | Bridges | 1 |

Ferramentas disponíveis

| Tool | Descrição | |------|-----------| | listar_tabelas | Lista todas as tabelas, com filtro por tipo (fato/dimensao/bridge) | | descrever_tabela | Schema completo de uma tabela: campos, tipos, PKs e notas | | buscar_schema | Busca por palavra-chave em nomes e descrições de tabelas/campos | | relacionamentos_tabela | Sugere JOINs entre tabelas com base em campos comuns | | gerar_sql | Queries SQL prontas para 15 casos de uso comuns | | visao_geral | Resumo completo do DW, módulos e guia de uso |

Instalação

npm install -g mcp-maximatech-dw

Publicar no npm

# 1. Fazer login no npm
npm login

# 2. Publicar
npm publish

Configurar no Claude Code (claude_desktop_config.json)

{
  "mcpServers": {
    "maximatech-dw": {
      "command": "npx",
      "args": ["-y", "mcp-maximatech-dw"]
    }
  }
}

Ou se instalado globalmente:

{
  "mcpServers": {
    "maximatech-dw": {
      "command": "mcp-maximatech-dw"
    }
  }
}

Configurar via arquivo .mcp.json (por projeto)

{
  "mcpServers": {
    "maximatech-dw": {
      "command": "npx",
      "args": ["-y", "mcp-maximatech-dw"]
    }
  }
}

Exemplos de uso

Listar todas as tabelas de fato

listar_tabelas(tipo: "fato")

Ver schema completo de uma tabela

descrever_tabela(nome_tabela: "fato_pedido_realizado")

Buscar onde ficam dados de motorista

buscar_schema(palavra_chave: "motorista")

Gerar SQL de vendas por vendedor

gerar_sql(caso_uso: "vendas_por_vendedor")

Casos de uso disponíveis no gerar_sql

• vendas_por_vendedor
• pedidos_realizados_periodo
• entregas_fora_raio
• pedidos_aprovados
• devolucoes_por_cliente
• estoque_atual
• km_percorrido_vendedor
• positivacao_clientes
• carregamentos_motorista
• faturamento_por_produto
• visitas_realizadas
• pesquisa_maxpesquisa
• acesso_por_fornecedor
• itens_faturados
• comodato_lancamentos

Desenvolvimento local

npm install
npm run build
npm start