适合谁
- 希望用最少工具数量、最省上下文窗口的方式接入数据库的场景
- 需要给非技术团队成员开放安全只读数据库访问权限的场景
D
74FMRS · B
来源与配置已复核
Bytebase 官方维护，工具数量克制到只有两个，MCP Bundle 的只读默认设计对非技术用户友好。核心风险在于 execute_sql 默认可执行任意 SQL，需要用户主动搭配只读账户或护栏参数。评分基于源码与文档静态核验，未实际连接数据库测试。
查看评分与验证方法 →由开源数据库 DevSecOps 平台 Bytebase 官方维护的 MCP Server，主打"零依赖、只用两个工具"的极简设计以节省上下文窗口：一个用于执行 SQL（带事务和安全控制），一个用于搜索探索数据库 schema。同时支持 PostgreSQL、MySQL、MariaDB、SQL Server、SQLite，可用 TOML 配置同时连接多个数据库，并提供只读模式、行数限制和查询超时等护栏。
工具能力
execute_sql
执行 SQL 查询，支持事务和安全控制
search_objects
搜索和探索数据库 schema、表、列、索引和存储过程
安装接入
1）NPM 直接运行：`npx @bytebase/dbhub@latest --transport stdio --dsn "postgres://user:pass@host:5432/db"`（Node.js ≥ 22.5.0）。
2）一键安装包：从 GitHub Release 下载 `.mcpb` 文件，拖入 Claude Desktop 等支持 MCPB 的客户端，本地 stdio 运行且默认只读，适合非技术团队成员使用。
3）Claude Code 用户可用官方插件一条命令注册，交互式录入连接串。
claude_desktop_config.json
{
"mcpServers": {
"dbhub": {
"command": "npx",
"args": ["-y", "@bytebase/dbhub", "--transport", "stdio"],
"env": {
"DSN": "postgres://user:password@localhost:5432/dbname?sslmode=disable"
}
}
}
}
选型与风险
不适合谁
- 需要执行数据库管理类操作（建索引、改 schema）而不只是查询的场景（DBHub 定位是查询而非 DBA 管理工具）
所需权限
- 需要数据库连接字符串（DSN），可能包含用户名密码等敏感信息
- execute_sql 默认可执行任意 SQL（含写操作），需要通过只读模式或数据库账户权限主动限制
风险与副作用
- 默认配置下 execute_sql 若连接的数据库账户拥有写权限，AI 助手可能执行意外的写入或删除操作，生产环境建议搭配只读数据库账户
- DSN 中包含明文密码，需注意配置文件的访问权限
常见排障
- 连接失败：检查 DSN 格式和 sslmode 参数是否匹配数据库实际配置
- 查询超时：确认是否命中了内置的查询超时护栏，可能是查询本身效率问题
- MCP Bundle 无法安装：确认客户端支持 MCPB 格式（modelcontextprotocol/mcpb）
使用场景
让 AI 助手直接查询业务数据库回答问题，无需手写 SQL
非技术同事通过只读 MCP Bundle 安全地查询数据库
探索陌生数据库的表结构、索引和字段
同时连接多个不同类型的数据库做统一查询入口
支持客户端
Claude Desktop完整支持
Claude Code完整支持
VS Code完整支持
Cursor完整支持
Zed完整支持