DBHub MCP Server

by bytebaseio.github.bytebase/dbhubv1.4.0

Token-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite

3.6kNode.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Activetoday

Install DBHub MCP server

claude mcp add dbhub -e DSN='<dsn>' -e DB_PASSWORD='<db-password>' -e SSH_PASSWORD='<ssh-password>' -e SSH_PASSPHRASE='<ssh-passphrase>' -- npx -y @bytebase/dbhub

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DSN": "<dsn>",
        "DB_PASSWORD": "<db-password>",
        "SSH_PASSWORD": "<ssh-password>",
        "SSH_PASSPHRASE": "<ssh-passphrase>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DSN": "<dsn>",
        "DB_PASSWORD": "<db-password>",
        "SSH_PASSWORD": "<ssh-password>",
        "SSH_PASSPHRASE": "<ssh-passphrase>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "dbhub": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DSN": "<dsn>",
        "DB_PASSWORD": "<db-password>",
        "SSH_PASSWORD": "<ssh-password>",
        "SSH_PASSPHRASE": "<ssh-passphrase>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DSN": "<dsn>",
        "DB_PASSWORD": "<db-password>",
        "SSH_PASSWORD": "<ssh-password>",
        "SSH_PASSPHRASE": "<ssh-passphrase>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
DSN	—	yes	Database connection string (e.g., postgres://user:pass@host:5432/db)
DB_TYPE	—	—	Database type: postgres, mysql, mariadb, sqlserver, oracle, sqlite
DB_HOST	—	—	Database hostname
DB_PORT	—	—	Database port
DB_USER	—	—	Database username
DB_PASSWORD	—	yes	Database password
DB_NAME	—	—	Database name or SQLite file path
TRANSPORT	—	—	Transport mode: stdio or http
PORT	—	—	HTTP server port (default: 8080)
ID	—	—	Instance identifier for tool names
SSH_HOST	—	—	SSH server hostname
SSH_PORT	—	—	SSH server port (default: 22)
SSH_USER	—	—	SSH username
SSH_PASSWORD	—	yes	SSH password
SSH_KEY	—	—	Path to SSH private key
SSH_PASSPHRASE	—	yes	SSH key passphrase

Freshness

Active — last maintenance signal today. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-09 · today · GitHub
Latest release
2026-09-28 · 10d ago · GitHub · v1.4.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-28 · 10d ago · official registry · v1.4.0

FAQ

›How do I install the DBHub MCP server in Claude Code?

Run: claude mcp add dbhub -e DSN='<dsn>' -e DB_PASSWORD='<db-password>' -e SSH_PASSWORD='<ssh-password>' -e SSH_PASSPHRASE='<ssh-passphrase>' -- npx -y @bytebase/dbhub. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does DBHub require an API key?

Yes. It expects DSN, DB_PASSWORD, SSH_PASSWORD, SSH_PASSPHRASE, of which 4 are secrets.

›Can I use DBHub as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is DBHub in the official MCP registry?

Yes, as io.github.bytebase/dbhub.