|
| 1 | +--- |
| 2 | +title: "DBHub 1.0.0" |
| 3 | +description: "DBHub reaches 1.0.0: native support for the new MCP 2026-07-28 spec, 17 months of iteration in numbers, and the MCP server the official Claude Code docs use to connect PostgreSQL." |
| 4 | +--- |
| 5 | + |
| 6 | +Today we're releasing **DBHub 1.0.0** — the first major version of our zero-dependency, token-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, and SQLite. |
| 7 | + |
| 8 | +## Why now |
| 9 | + |
| 10 | +The Model Context Protocol shipped its [2026-07-28 spec revision](https://blog.modelcontextprotocol.io/posts/2026-07-28/) this week — the largest protocol change since MCP launched, making the protocol stateless at its core. DBHub adopted it the same week: the stateless serving model, cacheable tool lists, and header-based routing are all live in 1.0.0, while 2025-era clients keep working unchanged on the same endpoints. We wrote up the adoption item by item, with before/after code, in [How DBHub Adopts the New MCP Spec 2026-07-28](/blog/how-dbhub-adopts-mcp-spec-2026-07-28). |
| 11 | + |
| 12 | +A protocol milestone deserved a version milestone. DBHub has been stateless by design since its first release; with the spec now guaranteeing that model, the architecture we bet on is standard — and that's what a 1.0 should mean. |
| 13 | + |
| 14 | +## 17 months in numbers |
| 15 | + |
| 16 | +Since the first commit in March 2025: |
| 17 | + |
| 18 | +- **573 commits** and **73 npm releases** — a release roughly every week |
| 19 | +- **164 pull requests** merged from **34 contributors** |
| 20 | +- **158 issues** closed, with only **3 open** at the time of writing |
| 21 | +- **3,200+ GitHub stars** and **270+ forks** |
| 22 | + |
| 23 | +Along the way DBHub grew from a single-database bridge into what ships in 1.0.0: multi-database TOML configuration with hot reload, custom parameterized tools, SSH tunnels with multi-hop ProxyJump, read-only enforcement backed by engine-level guards, a built-in web workbench, an MCP Bundle for one-click Claude Desktop install, and a Claude Code plugin. |
| 24 | + |
| 25 | +## The official way to connect Claude Code to Postgres |
| 26 | + |
| 27 | +DBHub is the MCP server the [official Claude Code documentation](https://code.claude.com/docs/en/mcp#example-query-your-postgresql-database) uses in its "Query your PostgreSQL database" example: |
| 28 | + |
| 29 | + |
| 30 | + |
| 31 | +```bash |
| 32 | +claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \ |
| 33 | + --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics" |
| 34 | +``` |
| 35 | + |
| 36 | +Then just ask: *"What's our total revenue this month?"* |
| 37 | + |
| 38 | +## Compatibility |
| 39 | + |
| 40 | +1.0.0 is a protocol upgrade, not a breaking release: every existing `dbhub.toml`, DSN, and command-line flag works unchanged, and 2025-era MCP clients are served transparently alongside 2026-07-28 clients. The one caveat for hand-rolled HTTP scripts is documented in the [adoption post](/blog/how-dbhub-adopts-mcp-spec-2026-07-28#5-compatibility-notes). |
| 41 | + |
| 42 | +Get started in one line: |
| 43 | + |
| 44 | +```bash |
| 45 | +npx @bytebase/dbhub --demo |
| 46 | +``` |
| 47 | + |
| 48 | +DBHub is open source under the MIT license at [github.com/bytebase/dbhub](https://github.com/bytebase/dbhub) — thanks to everyone who filed the 158 issues and sent the 164 pull requests that got it here. |
0 commit comments