DBeaver MCP Server 插件
把 DBeaver 桌面端变成本机 MCP 服务：AI 客户端可以复用用户已经保存并明确授权的连接，读取数据库结构、跨连接搜索表和字段、定位数据值并执行任意 SQL。
服务只监听 127.0.0.1。新连接默认不授权，访问令牌默认隐藏，插件不会向 MCP 暴露连接创建、修改或删除能力。
亮点功能
- 不制造重复连接：只复用 DBeaver 中已经存在并由用户明确授权的连接，不通过 MCP 创建、修改或删除 DBeaver 连接。
- PostgreSQL 跨数据库访问：一个连接即可通过
database参数访问同一服务器上的其他数据库，不修改原连接的默认数据库，也不会在数据库导航中留下临时连接。 - 不知道表在哪也能查：后台建立不包含密码和业务行的本地结构索引，一次搜索多个连接、数据库、Schema、表、视图、字段和注释。
- 按实际值反查位置：
find_data_value可以定位某个值存在于哪个连接、数据库、表和字段，只返回位置，不返回完整业务行。 - 允许执行任意 SQL：支持查询、插入、更新、删除、DDL 和过程调用，实际权限由数据库账号决定。
- 批量跨库执行：一次最多执行 20 个 SQL 任务，最多并行 2 个；单个数据库失败时，可以继续处理其他数据库。
- 连接未打开也能使用：SQL、结构读取和索引工具会按需打开已授权连接，也可以显式连接、断开或测试连接。
- 本机安全访问：服务只监听
127.0.0.1，使用 Bearer 令牌认证，拒绝外部网页来源，不返回密码、私钥和安全存储内容。 - 安装简单、兼容旧版：提供 Windows 一键安装包，最低支持 DBeaver Community 23.0.0。
全部 MCP 工具
当前共提供 21 个工具。除 execute_sql 和 execute_sql_batch 外，其他工具不会执行用户提供的写入 SQL；连接状态工具只影响 DBeaver 的运行状态，结构索引工具只写入插件在本机保存的缓存。
PostgreSQL 的 database 参数适用于 test_connection、execute_sql、execute_sql_batch 中的每个任务、get_database_info、全部即时结构工具和 explain_sql。插件会建立不注册到 DBeaver 工作区的短暂 JDBC 会话，校验实际数据库后执行，并在调用结束时关闭；省略 database 时继续使用原 DBeaver 连接的默认数据库。
最快安装
- 从 GitHub Releases 下载
dbeaver-mcp-windows-0.3.0-SNAPSHOT.zip，并完整解压。 - 双击
安装插件.cmd。 - 如果 DBeaver 正在运行，保存工作并完全退出，然后按回车继续。
- 安装器会自动查找 DBeaver、备份配置、安装或升级插件并重新启动 DBeaver。
- 打开“窗口 → 首选项 → MCP 服务”，勾选允许访问的连接，再点击“保存并启动”。
查看 v0.3.0-preview.2 发布说明 · 下载 SHA-256 校验文件
下面是 DBeaver 25.0.2 中实际运行的 0.3.0 设置页截图，包含“全部勾选”“取消全选”和“刷新结构索引”，访问令牌已由密码框遮挡：
详细步骤、工具参数和操作图见中文安装与使用说明。
兼容范围
最低支持 DBeaver Community 23.0.0。
发布 Bundle 是 Java 11 字节码，Feature 最低依赖是 org.jkiss.dbeaver.ui.feature 23.0.0。低于 23.0.0 的版本未承诺兼容，安装器会阻止明显过低的版本。当前一键安装包针对 Windows x86_64；其他系统可以使用标准 P2 更新站点，但尚未完成同等强度的真机验证。
安全提醒
插件不限制 execute_sql 和 execute_sql_batch 的 SQL 类型，实际权限由数据库账号决定。生产库应使用符合任务需要的最小权限账号，并只授权确实需要交给 MCP 的连接。
元数据索引不保存密码、令牌、SSH 秘密或实际业务行。find_data_value 必须传入 confirm=true，只对索引筛选出的候选字段执行参数化存在性查询。
更新日志
仓库使用 CHANGELOG.md 长期维护更新记录，格式参考 Keep a Changelog：
- 开发中的用户可感知变化先写入“未发布”。
- 发布时移入对应版本并填写日期。
- GitHub Release 提供当次下载和摘要，
CHANGELOG.md保留完整历史。
构建
准备完整 JDK 21 或更高版本以及 Maven 3.9+：
$env:JAVA_HOME = "C:\path\to\jdk-21"
$env:Path = "$env:JAVA_HOME\bin;$env:Path"
mvn -B clean verify
.\scripts\verify-update-site.ps1
构建生成：
- 标准 P2 更新站点：
repository/io.github.jiaheng6.dbeaver.mcp.repository/target/repository - Windows 一键安装包：
repository/io.github.jiaheng6.dbeaver.mcp.repository/target/dbeaver-mcp-windows-0.3.0-SNAPSHOT.zip
最低版本 API 验证：
.\scripts\verify-local-dbeaver-compatibility.ps1 `
-DBeaverHome "D:\path\to\dbeaver-23.0.0" `
-JavaHome "C:\path\to\jdk-21"
许可证
Apache License 2.0。DBeaver 是独立项目，本插件不是 DBeaver Corp 官方产品。