Skip to content

Commit 7bb050e

Browse files
committed
docs: add token efficiency comparison and use cases, remove star history from blog posts
- Add Token Efficiency section with comparison table before Use Cases - Add Use Cases section sourced from community feedback (#146) - Highlight DBHub as official Claude Code docs PostgreSQL MCP example - Remove star history charts from 3 blog review posts
1 parent 159c549 commit 7bb050e

5 files changed

Lines changed: 24 additions & 12 deletions

README.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,18 @@ DBHub is a minimal MCP server: token-efficient, zero-dependency, and just two to
3838
- **Guardrails**: Read-only mode, row limiting, and query timeout to prevent runaway operations
3939
- **Secure Access**: SSH tunneling and SSL/TLS encryption
4040

41+
> DBHub is the official example in the [Claude Code docs](https://code.claude.com/docs/en/mcp#example-query-your-postgresql-database) for connecting to PostgreSQL via MCP.
42+
43+
## Token Efficiency
44+
45+
DBHub loads just 2 tools by default at **1.4k tokens** — 13-14x fewer than alternatives — keeping the context window open for your actual work.
46+
47+
| MCP Server | Default Config | Default Tools |
48+
|------------|---------------|--------------|
49+
| **DBHub** | **1.4k** | 2 (`execute_sql`, `search_objects`) |
50+
| MCP Toolbox | 19.0k | 28 |
51+
| Supabase MCP | 19.3k | all |
52+
4153
## Use Cases
4254

4355
- **Local Development**: Schema exploration, query validation, and data debugging with Claude Code, VS Code, Cursor, etc.

docs/blog/postgres-mcp-server-review-dbhub.mdx

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,6 @@ _Last updated: Dec 28, 2025_
77

88
This is the third in a series reviewing Postgres MCP servers. Here we—the DBHub maintainers—explain the design behind [DBHub](https://github.com/bytebase/dbhub), a zero-dependency, token efficient MCP server that connects AI assistants to PostgreSQL, MySQL, MariaDB, SQL Server, and SQLite. We'll cover our design decisions, trade-offs, and where DBHub falls short compared to alternatives.
99

10-
- **GitHub Stars**
11-
12-
[![Star History Chart](https://api.star-history.com/svg?repos=bytebase/dbhub&type=date&legend=top-left)](https://www.star-history.com/#bytebase/dbhub&type=date&legend=top-left)
13-
1410
- **License:** MIT
1511
- **Language:** TypeScript
1612

docs/blog/postgres-mcp-server-review-mcp-toolbox.mdx

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,6 @@ _Last updated: Dec 20, 2025_
99
This is the first in a series of deep-dive reviews examining popular Postgres MCP servers. We begin with [MCP Toolbox for Databases](https://github.com/googleapis/genai-toolbox),
1010
an open-source MCP server developed by Google that supports a wide range of databases and data platforms including PostgreSQL, MySQL, BigQuery, MongoDB, and many others.
1111

12-
- **GitHub Stars**
13-
14-
[![Star History Chart](https://api.star-history.com/svg?repos=googleapis/genai-toolbox&type=date&legend=top-left)](https://www.star-history.com/#googleapis/genai-toolbox&type=date&legend=top-left)
15-
1612
- **License:** Apache-2.0
1713
- **Language:** Go
1814

docs/blog/postgres-mcp-server-review-supabase-mcp.mdx

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,6 @@ _Last updated: Dec 22, 2025_
77

88
This is the second in a series of deep-dive reviews examining popular Postgres MCP servers. We're reviewing [Supabase MCP Server](https://github.com/supabase-community/supabase-mcp), a MCP server that gives AI assistants direct access to Supabase projects for database operations, schema changes, and project configuration.
99

10-
- **GitHub Stars**
11-
12-
[![Star History Chart](https://api.star-history.com/svg?repos=supabase-community/supabase-mcp&type=date&legend=top-left)](https://www.star-history.com/#supabase-community/supabase-mcp&type=date&legend=top-left)
13-
1410
- **License:** Apache-2.0
1511
- **Language:** TypeScript
1612

docs/index.mdx

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,18 @@ DBHub is a minimal MCP server: token-efficient, zero-dependency, and just two to
3333
MCP Clients MCP Server Databases
3434
```
3535

36+
> DBHub is the official example in the [Claude Code docs](https://code.claude.com/docs/en/mcp#example-query-your-postgresql-database) for connecting to PostgreSQL via MCP.
37+
38+
## Token Efficiency
39+
40+
DBHub loads just 2 tools by default at **1.4k tokens** — 13-14x fewer than alternatives — keeping the context window open for your actual work.
41+
42+
| MCP Server | Default Config | Default Tools |
43+
|------------|---------------|--------------|
44+
| **DBHub** | **1.4k** | 2 (`execute_sql`, `search_objects`) |
45+
| MCP Toolbox | 19.0k | 28 |
46+
| Supabase MCP | 19.3k | all |
47+
3648
## Use Cases
3749

3850
- **Local Development**: Schema exploration, query validation, and data debugging with Claude Code, VS Code, Cursor, etc.

0 commit comments

Comments
 (0)