DBHub

Minimal, token-efficient Database MCP Server for PostgreSQL, MySQL, SQL Server, SQLite, MariaDB

io.github.bytebase/dbhub · Repository · version 1.2.0 · 3.4k stars · listed from registry

Install

The sweep installs into a clean prefix, but this is the command a user would run:

npx @bytebase/dbhub

Results by platform

Linux

MCP handshake failed2026-08-16 · probed over npm

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
ERROR: Database connection configuration is required.
Please provide configuration in one of these ways (in order of priority):

1. Use demo mode: --demo (uses in-memory SQLite with sample employee database)
2. TOML config file: --config=path/to/dbhub.toml or ./dbhub.toml
3. Command line argument: --dsn="your-connection-string"
4. Environment variable: export DSN="your-connection-string"
5. .env file: DSN=your-connection-string

Example DSN formats:
  - sqlserver: sqlserver://username:password@localhost:1433/database?sslmode=disable&instanceName=INSTANCE1
  - sqlite: sqlite:///path/to/database.db
  - mysql: mysql://root:password@localhost:3306/mysql?sslmode=require
  - postgres: postgres://postgres:password@localhost:5432/postgres?sslmode=require
  - mariadb: mariadb://root:password@localhost:3306/db?sslmode=require

Example TOML config (dbhub.toml):
  [[sources]]
  id = "my_db"
  dsn = "postgres://user:pass@localhost:5432/dbname"

See documentation for more details on configuring database connections.

macOS

MCP handshake failed2026-08-16 · probed over npm

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
ERROR: Database connection configuration is required.
Please provide configuration in one of these ways (in order of priority):

1. Use demo mode: --demo (uses in-memory SQLite with sample employee database)
2. TOML config file: --config=path/to/dbhub.toml or ./dbhub.toml
3. Command line argument: --dsn="your-connection-string"
4. Environment variable: export DSN="your-connection-string"
5. .env file: DSN=your-connection-string

Example DSN formats:
  - sqlserver: sqlserver://username:password@localhost:1433/database?sslmode=disable&instanceName=INSTANCE1
  - sqlite: sqlite:///path/to/database.db
  - mysql: mysql://root:password@localhost:3306/mysql?sslmode=require
  - postgres: postgres://postgres:password@localhost:5432/postgres?sslmode=require
  - mariadb: mariadb://root:password@localhost:3306/db?sslmode=require

Example TOML config (dbhub.toml):
  [[sources]]
  id = "my_db"
  dsn = "postgres://user:pass@localhost:5432/dbname"

See documentation for more details on configuring database connections.

Windows

timed out2026-08-16 · probed over npm

1 recorded run, oldest first.

npm install @bytebase/[email protected] timed out after 600s

Badge

Paste this into the project README to show the current result:

[![does it install](https://img.shields.io/endpoint?url=https://doesitinstall.com/badge/io.github.bytebase__dbhub.json)](https://doesitinstall.com/s/io.github.bytebase__dbhub.html)