dsh-db-mcp
Verifieddsh-db-mcp · v0.9.4 · Apache-2.0 · Web UI
DSH plugin: import the connections DBeaver already knows (saved passwords included), then let the agent query SQLite, PostgreSQL, MySQL, Oracle and openGauss through nine MCP tools - read-only by default, every call audited.
Install
dsh plugin add dsh-db-mcp Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-db-mcp
English | 中文
一个 DSH 插件,把你已有的数据库连接直接变成智能体能用的工具。从 DBeaver 导入、勾选、提问——连接串不用重打,DSH 文件不用改,Python 也不用自己装。
界面截图
从 DBeaver 导入。 导入器读取 DBeaver 工作区的 data-sources.json,再用 DBeaver 自带的密钥解密 credentials-config.json,主机、端口、库名、用户、已存口令一次到位;已经登记过的连接会被标出来,同一个地址不会重复添加。

数据源列表。 顶部是健康概览,数据源按你的分组排列,带引擎徽标;探测失败的那条就地把完整报错摊开,旁边一键复制。

三个方面都不用配
- 不用改 DSH 文件。 bundle 的 patch 只插入一行 Loader 记录;插件自己用 stdio 拉起 Python MCP 服务,并把工具注册到 Host 的
tools服务上——不需要dsh-mcp-client那一行,也不用编辑 JSON、导环境变量。 - 不用填数据源。 导入器读取 DBeaver 工作区的
data-sources.json,再用 DBeaver 自带的密钥解密credentials-config.json,主机、端口、库名、用户、已存口令一次到位。勾一个框就是全部配置工作。 - 不用准备 Python。 面板会自己找解释器、建 venv、装四个驱动包,入口在 运行时诊断 → 安装 / 修复依赖。
运行
dsh plugin --profile desktop add dsh-db-mcp # 桌面端
dsh plugin --profile web add dsh-db-mcp # Web 端
--profile 指定装进哪个 profile(随 DSH 提供的是 desktop 与 web,其它名字首次使用时自动创建)。卸载用
dsh plugin --profile desktop remove dsh-db-mcp。
然后:
- 侧栏 → 数据库。
- 从 DBeaver 导入 → 勾选连接 → 导入所选。
- 问智能体一句:「我的 Chinook 库里有哪些表?」
如果某条连接在 DBeaver 里没保存口令,卡片会显示无密码;打开该数据源补一次即可——口令只写进 secrets.json,不会再回到页面上。
想从零开始也行:新建数据源里粘一条连接串(postgresql://user:pw@host:5432/db、JDBC URL、Oracle TNS 描述符或 .db 路径),表单会自动填好。
智能体拿到的工具
| 工具 | 作用 |
|---|---|
mcp__db__list_datasources |
已登记的数据源:id、类型、目标、是否只读 |
mcp__db__list_tables |
某个源里的表与视图 |
mcp__db__describe_table |
列、类型、可空、主键 |
mcp__db__sample_rows |
取几行样本 |
mcp__db__execute_sql |
执行一条语句——查询,或在允许写入时执行写入 |
mcp__db__explain_query |
执行计划 |
mcp__db__get_ddl |
CREATE TABLE 语句 |
mcp__db__test_connection |
真实登录 + select 1,回报服务器/用户/schema |
mcp__db__session_scope |
把本会话限制在部分数据源,或解除限制 |
datasource 在所有工具里都是可选的,省略时回落到标着 isDefault 的那条(没有就取注册表里的第一条)。查询发生在对话里,面板只负责管理连接,不是 SQL 控制台。
安全
- 默认只读,两道互相独立的闸门:全局写开关 + 单源标记,两者都打开才允许写入。
- 口令不出本机。 存在
secrets.json(0600);任何 HTTP 接口都不返回它,Python 子进程拿到的也只是很短的环境变量白名单,而不是整个 DSH 环境。 - 每次工具调用都有审计,写入
logs/audit.jsonl——工具、数据源、耗时、行数、SQL;结果行永不记录。 - 面板不会执行 SQL。 结构浏览只转发
list_tables与describe_table。
文档
| 文档 | 内容 |
|---|---|
| docs/guide.zh.md | 面板操作、连接串、分组、Docker 测试库、排错(中文) |
| docs/reference.md | HTTP 接口、工具契约、注册表与设置文件、插件配置(英文) |
| docs/development.md | 目录结构、热重载、测试套件、发布流程(英文) |
| docs/design-notes.md | 设计日志(P1 → P7)与决策记录(英文) |
许可
Apache License 2.0 —— 见 LICENSE。