Dbhub

Name: Dbhub
Author: bytebase

本地服务

dbhub.ai数据库3.7k2 天前更新

代码仓库访问官网

关于 Dbhub

DBHub 是一个面向 PostgreSQL、MySQL、SQL Server、MariaDB、Oracle 和 SQLite 的数据库 MCP 服务，零依赖且默认只暴露两个工具以节省上下文。它适合希望以只读或受限方式让 AI 客户端查询数据库的开发者。

主要功能

01零依赖的轻量 MCP 服务
02默认仅提供两个工具
03支持多种数据库统一接口
04只读模式与查询行数及超时限制
05支持 SSH 隧道与 SSL/TLS 加密
06内置 Workbench 网页界面

适用场景

01借助 Claude Code 或 Cursor 进行本地开发时探索数据库结构
02向非技术人员开放只读视图
03用单个进程替代多个数据库 MCP 服务
04在生产环境进行只读诊断

MCP 相关

DBHub 是 MCP 服务，向 Claude Desktop、Claude Code、Cursor 等 MCP 客户端暴露 execute_sql、search_objects 等数据库工具，并可通过 dbhub.toml 定义自定义工具。

#mysql #postgres #database #ai #sqlite #mcp #oracle #mariadb #cursor #sqlserver #claude #dify #anthropic #claude-ai #cursorai #mcp-server #dify-plugins

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DSN": "<DSN>",
        "DB_TYPE": "<DB_TYPE>",
        "DB_HOST": "<DB_HOST>",
        "DB_PORT": "<DB_PORT>",
        "DB_USER": "<DB_USER>",
        "DB_PASSWORD": "<DB_PASSWORD>",
        "DB_NAME": "<DB_NAME>",
        "TRANSPORT": "<TRANSPORT>",
        "PORT": "<PORT>",
        "ID": "<ID>",
        "SSH_HOST": "<SSH_HOST>",
        "SSH_PORT": "<SSH_PORT>",
        "SSH_USER": "<SSH_USER>",
        "SSH_PASSWORD": "<SSH_PASSWORD>",
        "SSH_KEY": "<SSH_KEY>",
        "SSH_PASSPHRASE": "<SSH_PASSPHRASE>",
        "SSH_AUTH_SOCK": "<SSH_AUTH_SOCK>"
      }
    }
  }
}

启动命令npx -y @bytebase/dbhub

需要配置的环境变量

DSN密钥Database connection string (e.g., postgres://user:pass@host:5432/db)

DB_TYPEDatabase type: postgres, mysql, mariadb, sqlserver, oracle, sqlite

DB_HOSTDatabase hostname

DB_PORTDatabase port

DB_USERDatabase username

DB_PASSWORD密钥Database password

DB_NAMEDatabase name or SQLite file path

TRANSPORTTransport mode: stdio or http

PORTHTTP server port (default: 8080)

IDInstance identifier for tool names

SSH_HOSTSSH server hostname

SSH_PORTSSH server port (default: 22)

SSH_USERSSH username

SSH_PASSWORD密钥SSH password

SSH_KEY密钥Path to SSH private key

SSH_PASSPHRASE密钥SSH key passphrase

SSH_AUTH_SOCK密钥Path to SSH agent socket

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@bytebase/dbhub1.5.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

说明

如果你需要一款企业级数据库 MCP 服务，具备 DBHub 未提供的内置防护措施，例如审批流程、访问控制、数据脱敏和审计日志，请查看 Bytebase。

            +------------------+    +--------------+    +------------------+
            |                  |    |              |    |                  |
            |  Claude Desktop  +--->+              +--->+    PostgreSQL    |
            |                  |    |              |    |                  |
            |  Claude Code     +--->+              +--->+    SQL Server    |
            |                  |    |              |    |                  |
            |  Cursor          +--->+    DBHub     +--->+    Oracle        |
            |                  |    |              |    |                  |
            |  VS Code         +--->+              +--->+    SQLite        |
            |                  |    |              |    |                  |
            |  Copilot CLI     +--->+              +--->+    MySQL         |
            |                  |    |              |    |                  |
            |                  |    |              +--->+    MariaDB       |
            |                  |    |              |    |                  |
            +------------------+    +--------------+    +------------------+
                 MCP Clients           MCP Server             Databases

DBHub 是一款极简 MCP 服务：节省令牌、零依赖，默认仅提供两个工具，还可按需启用其他工具。这个轻量级网关可让兼容 MCP 的客户端连接并探索不同的数据库：

极简：零依赖、节省令牌，提供精简的 MCP 工具集，最大限度地利用上下文窗口
多数据库：通过单一接口支持 PostgreSQL、MySQL、MariaDB、SQL Server、Oracle 和 SQLite
多连接：通过 TOML 配置同时连接多个数据库
防护措施：只读模式、行数限制和查询超时，防止操作失控
安全访问：SSH 隧道和 SSL/TLS 加密

DBHub 是 Claude Code 文档中通过 MCP 连接 PostgreSQL 的官方示例。

令牌效率

DBHub 默认只加载 2 个工具，仅占用 1.4k 个令牌，比其他方案少 13–14 倍，让上下文窗口留给实际工作。

MCP 服务	默认配置	默认工具
DBHub	1.4k	2 (`execute_sql`, `search_objects`)
MCP Toolbox	19.0k	28
Supabase MCP	19.3k	全部

使用场景

本地开发：使用 Claude Code、VS Code、Cursor 等进行架构探索、查询验证和数据调试。
非技术人员访问：通过 Claude Desktop、VS Code、Cursor 等向非技术人员开放经过筛选的只读视图。
整合多个数据库：用单个 DBHub 进程替代每个数据库各自独立的 MCP 服务
生产环境故障排查：在防止查询失控的防护措施下进行只读诊断

支持的数据库

PostgreSQL、MySQL、SQL Server、MariaDB、Oracle 和 SQLite。

MCP 工具

DBHub 实现了用于数据库操作的 MCP 工具：

execute_sql：执行 SQL 查询，支持事务和安全控制
search_objects：搜索和探索数据库架构、表、列、索引及存储过程，并逐步展示信息
explain_sql（按需启用）：显示查询的执行计划，但不运行查询
health_check（按需启用）：报告连接池状态和缓冲区缓存命中率
自定义工具：在 dbhub.toml 配置文件中定义可复用的参数化 SQL 操作

工作台

DBHub 内置了一个网页界面，可用于与数据库工具交互。无需 MCP 客户端，即可通过可视化方式执行查询、运行自定义工具并查看请求跟踪记录。

工作台

安装

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

也可通过以下方式获取：

Docker 镜像
MCP Bundle（一键安装，只读）
Claude Code 插件

有关所有选项，请参阅安装指南；有关参数，请参阅命令行选项；有关同时连接多个数据库的说明，请参阅多数据库配置。

开发

需要 Node.js >= 22.5.0（DBHub 使用内置的 node:sqlite 模块）。

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build and run for production
pnpm build && pnpm start --transport stdio --dsn "postgres://user:password@localhost:5432/dbname"

请参阅测试和调试。