项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3808
使用教程
环境要求
- 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
上一篇:MathModelAgent
下一篇:reflexion
同类项目推荐
rosa
开源
用自然语言对话,轻松调试和操作 ROS 机器人。
ROSA is an AI Agent designed to interact with ROS1- and ROS2-based robotics systems···
Awesome-AGI-Agents
开源
一站式逛遍 AGI 智能体优质项目,快速上手不迷路
Awesome list of AGI Agents. Agents 精选资源合集.
MultiAgent-Search
开源
多智能体协作搜索入门实战,读懂 Agent 分工与汇总
轻量级多智能体协作系统 —— AI Agent 开发入门实战项目
caracal
开源
给AI智能体装上权限围栏,越权操作全拦截
Authority, not credentials, for AI agents: policy-approved actions, delegation that ···
ChatArena
开源
搭建多智能体语言游戏场,锻炼 AI 沟通协作能力
ChatArena (or Chat Arena) is a Multi-Agent Language Game Environments for LLMs. The ···
agentic-ai-apis
开源
汇集2000+生产级API,即插即用,快速构建AI智能体。
The ultimate collection of APIs for building autonomous AI agents — 2,036 productio···
OpenClawChineseTranslation
开源
让中文用户零门槛用上开源 AI 助手,多平台随时聊
OpenClaw (Clawdbot/Moltbot) 汉化版 - 开源个人 AI 助手中文版 | Claude/ChatGPT LLM 接入···
skills
开源
给AI桌面应用换肤:参考图秒变可逆皮肤,自动验证发布
Agent Skills for theming AI desktop apps: reference image → reversible Codex/WorkBu···
nanobot
开源
安在自己电脑上的 AI 管家,随叫随到,指哪打哪
Your lightweight open-source personal agent.
