DBHub 数据库查询与操作

这个技能解决什么问题

MCP 客户端要读写数据库时，通常得靠 Agent 现编一套 MySQL/Postgres 客户端逻辑：管理连接、处理鉴权、解析表结构、拼接 SQL，再把结果重新序列化给模型。这套轮子既难审计，也容易因为生成错误 SQL 而拖垮 token 预算。

这个技能把 DBHub 接入 MCP 客户端，把数据库探查和 SQL 执行变成一组受保护、token 效率更高的现成工具，让 Agent 直接复用。

核心能力

• 通过 DBHub 暴露数据库探查（inspection）与 SQL 工具，把「查 schema、看数据、跑语句」变成可直接调用的工具调用。
• 覆盖 Postgres、MySQL、SQL Server、MariaDB、SQLite 五种数据库，统一一套接口。
• 内置 Web 界面：可视化执行查询、运行自定义工具，并查看 request traces，便于调试与审计。
• 强调 guarded：数据库访问受控，避免 Agent 拿到裸连接后随意操作。
• token-efficient：工具输出面向模型消费做了压缩，减少把大结果集原样灌进上下文的开销。

关键步骤

1. 准备运行环境：Node.js 22.5 及以上，或改用 Docker 容器方式运行。
2. 提供目标数据库的 DSN/配置，并准备一个 MCP 兼容客户端。
3. 启动 DBHub 服务，让客户端通过统一的 MCP 接口发现并调用工具。
4. 在 Web 界面或客户端侧执行查询、自定义工具与追踪查看。

适用边界与注意点

• 版本要求是硬约束：走 NPM 方式时必须 Node.js >= 22.5.0，因为 DBHub 依赖 Node 内置的 node:sqlite 模块。
• 环境二选一：本地 Node 环境或 Docker，按自己的部署条件选择上游推荐的安装路径。
• DSN 是接入前提：没有正确配置连接串，工具无法指向具体数据库，技能本身不内置数据源。
• 访问受保护：适合需要限制 Agent 数据库权限的场景；不要把它当成无鉴权的通用数据库客户端。
• 上游文档为准：本技能提取自 DBHub 上游 README，完整安装与配置细节以官方文档为准。