MCP 服务器

dsh-dbhub-live

This MCP server enables AI models to directly and securely query databases using persistent or temporary connections, supporting multiple data sources with automatic connection management.

README

dsh-dbhub-live

让 DeepSeek Harness (DSH) 直接、安全地操作数据库：常驻多源连接 + 按工作区工具 + 临时动态连接。

dsh-dbhub-live 是一个 DSH 插件，基于 DBHub（数据库 MCP 服务器）让模型直接查询数据库：既能在已配置的工作区上复用常驻连接，也能临时连任意库做一次性排查。

✨ 特性

常驻多源服务 — 后台一个 dbhub 服务同时接入多个数据源，连接复用、查询更快。
按工作区工具 — dbhub_execute_sql_<工作区> / dbhub_search_objects_<工作区>，工具名即工作区，多工作区不混淆，连接标注（密码打码）清晰可见。
临时动态连接 — dbhub_query / dbhub_query_objects 每次独立连任意库，可并行查多个不同库，便于跨环境排查。
开箱即用 — 未安装 dbhub 时首次使用自动安装，之后自动保持更新，无需手动处理。
多种配置方式 — 显式 DSN / 填写分项 / 授权扫描项目配置文件，凭据仅存本机用户目录，密码全程脱敏。

支持的数据源

MySQL · PostgreSQL · MariaDB · SQLite · SQL Server

环境要求

DeepSeek Harness 的 dsh CLI（dsh web 负责 GUI 运行）
推荐本机有 Node.js ≥ 18（含 npm）——首次使用会自动安装 dbhub

安装

# 方式一：使用本机已安装的 dsh
dsh plugin --profile web add dsh-dbhub-live

# 方式二：通过 npx 调用 dsh（无需本机全局安装 dsh）
npx @deepseek-ai/dsh plugin --profile web add dsh-dbhub-live

安装后重启 dsh web 生效。

快速开始

# 1) 为当前工作区配置数据库连接（三种方式任选其一）
dbhub_configure

# 2) 在已配置工作区的常驻连接上执行查询
dbhub_execute_sql_myapp  SELECT * FROM users LIMIT 10;

# 3) 临时连任意库做一次性排查
dbhub_query  dsn=mysql://root:pass@192.168.77.6:3306/tx_sd_jinengshu  sql="SHOW TABLES;"

工具

工具	说明
`dbhub_configure(workspace?, dsn?)`	为工作区配置/持久化数据库连接。
`dbhub_execute_sql_<工作区>`	在指定工作区的常驻连接上执行 SQL。
`dbhub_search_objects_<工作区>`	在指定工作区搜索数据库对象（表/视图/列/索引等）。
`dbhub_query(dsn, sql)`	临时连接任意库执行 SQL（多语句用 `;` 分隔）。
`dbhub_query_objects(dsn, ...)`	临时连接任意库搜索数据库对象。

注：search_objects 仅对 SQLite 开放；MySQL / PostgreSQL 等请用 dbhub_query 直接查（如 SHOW TABLES）。

配置方式

显式 DSN — 传入完整连接串，如 mysql://user:pass@host:3306/db。
填写分项 — 按类型 / 主机 / 端口 / 账号 / 密码 / 库名依次填写。
授权扫描 — 授权后扫描项目配置文件（.env、application*.yml、docker-compose、jdbc.properties 等），列出候选（密码打码）供你确认。

工作区若已有 mise env 或 .env（DSN / DB_*），插件会自动发现，无需手动配置。

🔄 dbhub 自动安装与更新

首次使用自动安装：本机没有 dbhub 时，插件会在第一次查询时自动安装，之后离线也可用。
自动保持更新：每 7 天在后台静默更新到最新版，失败则沿用现有版本。
不碰你的配置：通过 PATH / mise 自行安装的 dbhub 不会被插件改动。

环境变量	说明	默认
`DSH_DBHUB_PACKAGE`	自动安装使用的 npm 包名	`@bytebase/dbhub`
`DSH_DBHUB_UPDATE_DAYS`	自动更新间隔天数，`0` 关闭	`7`

数据位置

所有配置与凭据存放在模块目录之外（不受 pnpm 打包影响），删除该目录即可完整清空：

~/.dsh/storages/dsh-dbhub-live/

卸载

dsh plugin --profile web remove dsh-dbhub-live

故障排查

现象	处理
首次使用报「无法获取 dbhub」	确认本机有 npm 且能联网；离线可手动安装 `dbhub` 并加入 PATH。
工具显示「dbhub 服务不可用」	查看 `dsh web` 日志；进程异常退出时插件会在下次调用自动重启。
扫描不到配置文件	默认跳过 `node_modules` / `.git` / `target` / `dist` 等目录，可改用「输入 DSN」或「填写分项」。
需要自定义 dbhub 版本	删除 `~/.dsh/storages/dsh-dbhub-live` 后设置 `DSH_DBHUB_PACKAGE` 指定包/版本。
不希望自动更新 dbhub	设置环境变量 `DSH_DBHUB_UPDATE_DAYS=0`。