DBHub

Servidor MCP de banco de dados universal com suporte a bancos de dados populares.

Documentação

[!NOTE]
Se você precisar de um servidor MCP de nível empresarial com proteções integradas, como fluxo de aprovação, controle de acesso, mascaramento de dados e registro de auditoria além do que o DBHub oferece, confira o Bytebase.

            +------------------+    +--------------+    +------------------+
            |                  |    |              |    |                  |
            |  Claude Desktop  +--->+              +--->+    PostgreSQL    |
            |                  |    |              |    |                  |
            |  Claude Code     +--->+              +--->+    SQL Server    |
            |                  |    |              |    |                  |
            |  Cursor          +--->+    DBHub     +--->+    Oracle        |
            |                  |    |              |    |                  |
            |  VS Code         +--->+              +--->+    SQLite        |
            |                  |    |              |    |                  |
            |  Copilot CLI     +--->+              +--->+    MySQL         |
            |                  |    |              |    |                  |
            |                  |    |              +--->+    MariaDB       |
            |                  |    |              |    |                  |
            +------------------+    +--------------+    +------------------+
                 MCP Clients           MCP Server             Databases

O DBHub é um servidor MCP minimalista: eficiente em tokens, sem dependências e com apenas duas ferramentas por padrão, além de extras opcionais. Este gateway leve permite que clientes compatíveis com MCP se conectem e explorem diferentes bancos de dados:

Mínimo: Zero dependências, eficiente em tokens, com um conjunto mínimo de ferramentas MCP para maximizar a janela de contexto
Multi-Banco de Dados: PostgreSQL, MySQL, MariaDB, SQL Server, Oracle e SQLite por meio de uma única interface
Multi-Conexão: Conecte-se a vários bancos de dados simultaneamente com configuração TOML
Proteções: Modo somente leitura, limite de linhas e tempo limite de consulta para evitar operações descontroladas
Acesso Seguro: Túnel SSH e criptografia SSL/TLS

O DBHub é o exemplo oficial na documentação do Claude Code para conectar-se ao PostgreSQL via MCP.

Eficiência de Tokens

O DBHub carrega apenas 2 ferramentas por padrão com 1,4k tokens — 13 a 14 vezes menos que as alternativas — mantendo a janela de contexto aberta para o seu trabalho real.

Servidor MCP	Configuração Padrão	Ferramentas Padrão
DBHub	1,4k	2 (`execute_sql`, `search_objects`)
MCP Toolbox	19,0k	28
Supabase MCP	19,3k	todas

Casos de Uso

Desenvolvimento Local: Exploração de esquemas, validação de consultas e depuração de dados com Claude Code, VS Code, Cursor, etc.
Acesso Não Técnico: Exponha visualizações selecionadas e somente leitura para equipes não técnicas via Claude Desktop, VS Code, Cursor, etc.
Consolidação Multi-Banco de Dados: Substitua servidores MCP separados para cada banco de dados por um único processo DBHub
Solução de Problemas em Produção: Diagnósticos somente leitura com proteções contra consultas descontroladas

Bancos de Dados Suportados

PostgreSQL, MySQL, SQL Server, MariaDB, Oracle e SQLite.

Ferramentas MCP

O DBHub implementa ferramentas MCP para operações de banco de dados:

execute_sql: Execute consultas SQL com suporte a transações e controles de segurança
search_objects: Pesquise e explore esquemas de banco de dados, tabelas, colunas, índices e procedimentos com divulgação progressiva
explain_sql (opcional): Mostre o plano de execução de uma consulta sem executá-la
health_check (opcional): Relate o estado do pool de conexões e a taxa de acerto do cache de buffer
Ferramentas Personalizadas: Defina operações SQL reutilizáveis e parametrizadas no seu arquivo de configuração dbhub.toml

Workbench

O DBHub inclui uma interface web integrada para interagir com suas ferramentas de banco de dados. Ela oferece uma maneira visual de executar consultas, executar ferramentas personalizadas e visualizar rastreamentos de solicitações sem exigir um cliente MCP.

workbench

Instalação

npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

Também disponível como:

Imagem Docker
Pacote MCP (instalação com um clique, somente leitura)
Plugin Claude Code

Consulte o Guia de Instalação para todas as opções, Opções de Linha de Comando para parâmetros e Configuração Multi-Banco de Dados para conectar vários bancos de dados de uma vez.

Desenvolvimento

Requer Node.js >= 22.5.0 (o DBHub usa o módulo node:sqlite integrado).

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build and run for production
pnpm build && pnpm start --transport stdio --dsn "postgres://user:password@localhost:5432/dbname"

Consulte Testes e Depuração.