dbhub

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 335 🐛 待处理 2 👀 关注 20
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 3808
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,可自行部署使用。

项目预览

dbhub 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开源模型
开发团队bytebase
官网地址https://dbhub.ai
定价模式🏷️完全免费
价格说明开源项目,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 星标★ 3808
上线时间2025-03-09 00:00:00
代码更新2026-11-08
仓库体积3.6 MB
本站数据更新2026-11-09
维护状态活跃
收录时间2026-08-09
浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3808

使用教程

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

环境要求

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

安装与启动步骤

  1. 1准备数据库连接串

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

  2. 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. 3源码方式安装依赖

    如果需要本地开发或修改源码,先克隆仓库并安装依赖(README 使用 pnpm install)。

    pnpm install
  4. 4开发模式运行

    在项目目录下以开发模式启动,便于调试和修改代码后即时生效。

    pnpm dev
  5. 5构建并以 stdio 运行

    生产环境用 pnpm build 构建后再启动,README 示例使用 stdio 传输,适合被 AI 客户端直接拉起。

    pnpm build && pnpm start --transport stdio --dsn "postgres://user:password@localhost:5432/dbname"

关键配置

配置项必填说明示例
--transport是指定 MCP 传输方式,可选 http 或 stdiohttp
--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···

★ 1683 2026-08-09
Awesome-AGI-Agents 开源

一站式逛遍 AGI 智能体优质项目,快速上手不迷路

Awesome list of AGI Agents. Agents 精选资源合集.

★ 570 2026-08-09
MultiAgent-Search 开源

多智能体协作搜索入门实战,读懂 Agent 分工与汇总

轻量级多智能体协作系统 —— AI Agent 开发入门实战项目

★ 350 2026-11-07
caracal 开源

给AI智能体装上权限围栏,越权操作全拦截

Authority, not credentials, for AI agents: policy-approved actions, delegation that ···

★ 229 2026-08-09
ChatArena 开源

搭建多智能体语言游戏场,锻炼 AI 沟通协作能力

ChatArena (or Chat Arena) is a Multi-Agent Language Game Environments for LLMs. The ···

★ 1569 2026-08-09
agentic-ai-apis 开源

汇集2000+生产级API,即插即用,快速构建AI智能体。

The ultimate collection of APIs for building autonomous AI agents — 2,036 productio···

★ 780 2026-08-09
OpenClawChineseTranslation 开源

让中文用户零门槛用上开源 AI 助手,多平台随时聊

OpenClaw (Clawdbot/Moltbot) 汉化版 - 开源个人 AI 助手中文版 | Claude/ChatGPT LLM 接入···

★ 3792 2026-08-09
skills 开源

给AI桌面应用换肤:参考图秒变可逆皮肤,自动验证发布

Agent Skills for theming AI desktop apps: reference image → reversible Codex/WorkBu···

★ 252 2026-08-09
nanobot 开源

安在自己电脑上的 AI 管家,随叫随到,指哪打哪

Your lightweight open-source personal agent.

★ 49963 2026-08-09