mcpdb

Community node para consultar a API MCP DB (vendas multi-tenant, read-only)

Package Information

Released: 4 mo ago
Downloads: 9 weekly / 166 monthly
Latest Version: 0.1.0
Author: CMX Tecnologia

Documentation

n8n-nodes-mcpdb

Community node do n8n para consultar a API MCP DB (vendas multi-tenant, somente leitura).
Uma credential com token (Bearer) define o tenant; o node respeita o isolamento por id_company.

Recursos

  • Credential MCP DB API — Base URL + Token, com botão Test (/api/v1/me).
  • Node MCP DB com operações:
    • Listar Tabelas — GET /api/v1/tables
    • Descrever Tabela — GET /api/v1/tables/:t/schema
    • Consultar — POST /api/v1/query (colunas, filtros visuais, ordenação, limite)
    • Agregar — POST /api/v1/aggregate (count/sum/avg/min/max + group by)
  • Usável como Tool por AI Agent do n8n (usableAsTool).

Build

cd n8n-nodes-mcpdb
npm install
npm run build      # gera dist/ (tsc + copia ícones)

Instalar no seu n8n (self-hosted)

Opção A — pasta custom (mais simples p/ testar)

# no servidor do n8n:
mkdir -p ~/.n8n/custom
cd ~/.n8n/custom
npm init -y                      # se ainda não existir package.json
npm install /caminho/para/n8n-nodes-mcpdb
# reinicie o n8n

Ou aponte N8N_CUSTOM_EXTENSIONS=/caminho/para/n8n-nodes-mcpdb e reinicie.

Opção B — GUI (requer publicar no npm)

Settings → Community Nodes → Install → n8n-nodes-mcpdb.
(Só funciona depois de npm publish.)

Usar

  1. Crie a credential MCP DB API: Base URL (ex: https://mcp.seudominio.com.br) + Token gerado no painel.
  2. Adicione o node MCP DB, escolha a operação e os parâmetros.
  3. Em AI Agent, conecte o node como Tool — o agente chama consultar/agregar sozinho.

Cada token só enxerga os dados do seu tenant; tudo é read-only.

Discussion