Repolode
Enviar
bytebase

bytebase/dbhub

Servidor MCP enxuto e econômico em tokens que permite a clientes de IA consultar e explorar bancos de dados PostgreSQL, MySQL, SQL Server, Oracle, MariaDB e SQLite.

Ver no GitHubSite
Estrelas
3,689
Forks
341
Issues abertas
2
Último commit
há 7 dias

O que é?

O DBHub é um servidor MCP (Model Context Protocol) que oferece a clientes compatíveis com MCP, como Claude Desktop, Claude Code, Cursor e VS Code, um gateway único para vários bancos de dados SQL. Ele é compatível com PostgreSQL, MySQL, MariaDB, SQL Server, Oracle e SQLite, e pode se conectar a vários bancos de dados ao mesmo tempo por meio de configuração TOML.

Por padrão, ele disponibiliza apenas duas ferramentas, execute_sql e search_objects, que, segundo o projeto, ocupam cerca de 1,4 mil tokens, deixando mais espaço livre na janela de contexto. Os recursos opcionais incluem explain_sql e health_check, além de ferramentas SQL personalizadas e parametrizadas, definidas em um arquivo dbhub.toml. Uma interface web integrada permite executar consultas e ferramentas sem um cliente MCP.

As opções de segurança incluem modo somente leitura, limites de linhas, tempos limite para consultas, tunelamento SSH e criptografia SSL/TLS. O servidor pode ser executado via npx, Docker, um MCP Bundle ou um plugin do Claude Code, e requer Node.js 22.5 ou posterior.

Recursos principais

  • 01Duas ferramentas MCP padrão (execute_sql e search_objects) para reduzir o uso de tokens.
  • 02Compatibilidade com PostgreSQL, MySQL, MariaDB, SQL Server, Oracle e SQLite por meio de uma única interface.
  • 03Conexão simultânea a vários bancos de dados via configuração TOML.
  • 04Modo somente leitura, limites de linhas e tempos limite para consultas como medidas de proteção.
  • 05Tunelamento SSH e criptografia SSL/TLS para conexões seguras.
  • 06Interface web integrada para executar consultas e ferramentas personalizadas.

Casos de uso

  • Explorar schemas e depurar dados com Claude Code, Cursor ou VS Code durante o desenvolvimento local.
  • Oferecer a funcionários sem conhecimento técnico acesso somente leitura a dados selecionados por meio de um cliente de IA.
  • Substituir servidores MCP separados por um único processo compatível com vários bancos de dados.
  • Executar diagnósticos de produção em modo somente leitura, com proteção contra consultas que não terminam.

Início rápido

  1. 1

    Inicie o DBHub com npx, informando o DSN do seu banco de dados

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

    Como alternativa, execute a imagem do Docker (consulte a seção de instalação do Docker)

Antes de usar

  • As compilações de desenvolvimento exigem Node.js 22.5.0 ou mais recente.

Tópicos

#mcp#database#sql#postgresql#mysql#sqlite#llm#ai-agents#agents#ai

Perguntas frequentes

O que é dbhub?
Servidor MCP enxuto e econômico em tokens que permite a clientes de IA consultar e explorar bancos de dados PostgreSQL, MySQL, SQL Server, Oracle, MariaDB e SQLite. O DBHub é um servidor MCP (Model Context Protocol) que oferece a clientes compatíveis com MCP, como Claude Desktop, Claude Code, Cursor e VS Code, um gateway único para vários bancos de dados SQL. Ele é compatível com PostgreSQL, MySQL, MariaDB, SQL Server, Oracle e SQLite, e pode se conectar a vários bancos de dados ao mesmo tempo por meio de configuração TOML.
dbhub é gratuito? Qual é a licença?
dbhub é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
dbhub ainda é mantido?
Manutenção ativa. O último commit de dbhub foi em 13 de out. de 2026.
Para que posso usar dbhub?
Explorar schemas e depurar dados com Claude Code, Cursor ou VS Code durante o desenvolvimento local. Oferecer a funcionários sem conhecimento técnico acesso somente leitura a dados selecionados por meio de um cliente de IA. Substituir servidores MCP separados por um único processo compatível com vários bancos de dados. Executar diagnósticos de produção em modo somente leitura, com proteção contra consultas que não terminam.
Como instalar dbhub?
Inicie o DBHub com npx, informando o DSN do seu banco de dados: npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable" Como alternativa, execute a imagem do Docker (consulte a seção de instalação do Docker)
Onde consigo dbhub?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/bytebase/dbhub

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados