dbhub

一个 MCP 服务器，让 AI 轻松连接五种数据库，即插即用。

dbhub 是一个极简的数据库 MCP（Model Context Protocol）服务器，专为 AI 助手提供统一的数据库访问接口。它支持 Postgres、MySQL、SQL Server、MariaDB 和 SQLite 五种主流数据库，让 AI 应用能够通过标准化的 MCP 协议直接查询和操作数据库，无需为每种数据库编写不同的适配代码。该项目解决了 AI 工具与数据库交互时缺乏统一标准、集成成本高的问题。其核心能力包括：通过 MCP 协议暴露数据库工具（如查询、执行 SQL）、轻量级配置、多数据库支持、以及基于 TypeScript 的可靠类型系统。dbhub 的设计强调极简，安装和配置简单，适合快速集成到基于 Claude、Cursor 等支持 MCP 的 AI 工作流中，帮助开发者构建数据感知的 AI 应用。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3559

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队bytebase

所属国家

官网地址https://dbhub.ai

GitHubhttps://github.com/bytebase/dbhub

定价模式free

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agents,ai,anthropic,claude,claude-ai,codex,cursor,database,llm,mariadb,mcp,mcp-server,mssql,mysql,oracle,postgres,postgresql,sql,sqlite,sqlserver

GitHub 星标★ 3559

30天Star增速

HF 下载量

上线时间2025-03-09 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：命令行工具 5 步

环境要求

Node.js 环境（npx 随 Node.js 一起提供）
一个可连接的数据库实例（Postgres、MySQL、SQL Server、MariaDB 或 SQLite）
对应数据库的 DSN 连接串
如需源码本地开发，需安装 pnpm 包管理器

安装与启动步骤

1准备数据库连接串

按 DSN 格式准备好连接信息，示例为 Postgres：postgres://用户名:密码@主机:5432/库名?sslmode=disable，替换成你自己的真实值。
2用 npx 启动服务

README 给出的标准安装方式，以 HTTP 传输方式启动 dbhub 并监听 8080 端口，全程无需 clone 代码。
```
npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
```
3源码方式安装依赖

如果需要本地开发或修改源码，先克隆仓库并安装依赖（README 使用 pnpm install）。
```
pnpm install
```
4开发模式运行

在项目目录下以开发模式启动，便于调试和修改代码后即时生效。
```
pnpm dev
```
5构建并以 stdio 运行

生产环境用 pnpm build 构建后再启动，README 示例使用 stdio 传输，适合被 AI 客户端直接拉起。
```
pnpm build && pnpm start --transport stdio --dsn "postgres://user:password@localhost:5432/dbname"
```

关键配置

配置项	必填	说明	示例
`--transport`	是	指定 MCP 传输方式，可选 http 或 stdio	`http`
`--port`	否	HTTP 传输模式下监听的端口号	`8080`
`--dsn`	是	数据库连接串，决定连接哪个数据库	`postgres://user:password@localhost:5432/dbname?sslmode=disab`

如何确认成功

启动后进程保持运行并在终端输出监听信息，HTTP 模式下 8080 端口可访问；从 Claude Desktop、Claude Code、Cursor 等 MCP 客户端能连上并列出数据库工具即成功。

常见问题

Q：支持哪些数据库？

A：支持 Postgres、MySQL、SQL Server、MariaDB 和 SQLite 五种主流数据库，通过 --dsn 连接串区分，无需为每种库写不同适配代码。

Q：不想装 Node.js 怎么办？

A：README 提供了其他安装形态：Docker 镜像、MCP Bundle（一键安装，只读）和 Claude Code 插件，具体用法见官网安装指南。

Q：可以同时连接多个数据库吗？

A：可以，README 指向 Multi-Database Configuration（TOML 配置）文档，用配置文件一次接入多个数据库。

Q：启动后客户端连不上怎么排查？

A：确认 transport 与客户端要求一致（本地客户端一般用 stdio，远程用 http），并检查端口和 DSN 是否正确；调试详见官方 Debug 文档。

注意事项

README 中的 DSN 为示例值，务必替换成自己的账号密码，不要把真实凭据提交到代码仓库。
MCP Bundle 的一键安装方式是只读模式，如需写操作请改用 npx 或源码方式。
npx 方式每次会拉取 @latest 最新版本，生产环境建议固定版本号以避免行为变化。
多数据库、Docker、命令行完整参数等进阶配置以官网 dbhub.ai 文档为准。

核心亮点

统一 MCP 协议，支持 Postgres、MySQL、SQL Server、MariaDB、SQLite 五种数据库，省去多套适配代码
极简设计，配置简单，几分钟内即可接入支持 MCP 的 AI 助手（如 Claude）
TypeScript 编写，类型安全，易于扩展和贡献

不足之处

功能相对基础，缺少高级数据库管理能力（如 Schema 可视化、复杂迁移工具）
文档/社区待观察

适用场景

AI 助手需要查询企业内部数据库以回答业务问题
开发者在 Cursor 或 Claude 中直接对本地 SQLite 或远程 Postgres 执行 SQL 调试
构建数据感知的聊天机器人，让用户通过自然语言操作数据库

替代项目

MCP Server for PostgreSQL、mysql-mcp-server、sqlite-mcp

项目介绍

dbhub 是智能体领域的开源项目，由 bytebase 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（3,559）位列前 30%，在智能体分类的 2,517 个项目里位列前 12%。

近 42 天，它的 GitHub 星标从 3,346 增加到 3,559，净增 213。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。MIT许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：AI助手需要查询企业内部数据库以回答业务问题。同类可对比的替代方案包括 MCP Server for PostgreSQL、mysql-mcp-server、sqlite-mcp。

上一篇：MathModelAgent

下一篇：reflexion