Dbeaver MCP

DBeaver MCP

一 MCP（模型上下文协议） 通过以下方式将AI工具连接到数据库的服务器 海狸。它读取您现有的DBeaver连接配置，并允许您直接从Claude Code和Gemini CLI等AI助手运行只读SQL查询。

内置Spring Boot和Spring AI。通过STDIO进行通信。

支持的数据库

局限性

• SSH：仅限密码身份验证。 不支持使用基于SSH密钥的身份验证（公钥/私钥）的连接，这些连接将被自动过滤掉。只有在DBeaver中配置了密码身份验证的SSH连接才能工作。
• 只读查询。 所有查询都在始终回滚的只读事务中运行。无法修改任何数据。
• B仅限屋檐连接。 服务器从DBeaver的配置文件中发现数据库。您无法提供手动连接字符串。

入门指南

先决条件

• 海狸 已安装，并配置了至少一个数据库连接。
• 无需Java安装-启动器脚本在首次运行时会自动下载JRE。

1.下载

去 发布 页面并下载适用于您平台的存档：

• Linux： dbeaver-mcp-linux.tar.gz
• 窗户： dbeaver-mcp-windows.zip

将存档解压缩到您选择的目录中。它包含两个文件：

dbeaver-mcp.jar
run.sh (Linux) / run.bat (Windows)

2.将MCP服务器添加到您的AI工具中

选择下面的工具并按照说明操作。

______________________________________________________________________

克劳德代码

项目范围（通过以下方式与您的团队共享 .mcp.json)

Linux：

claude mcp add --scope project --transport stdio dbeaver-mcp -- /path/to/dbeaver-mcp-linux/run.sh

窗户：

claude mcp add --scope project --transport stdio dbeaver-mcp -- cmd /c C:\path\to\dbeaver-mcp-windows\run.bat

用户范围（适用于所有项目）

Linux：

claude mcp add --scope user --transport stdio dbeaver-mcp -- /path/to/dbeaver-mcp-linux/run.sh

窗户：

claude mcp add --scope user --transport stdio dbeaver-mcp -- cmd /c C:\path\to\dbeaver-mcp-windows\run.bat

替换 /path/to/ 或 C:\path\to\ 使用提取存档的实际路径。

______________________________________________________________________

Gemini CLI

将服务器添加到您的 ~/.gemini/settings.json 文件。如果文件不存在，则创建该文件。

Linux：

{
  "mcpServers": {
    "dbeaver-mcp": {
      "command": "/path/to/dbeaver-mcp-linux/run.sh"
    }
  }
}

窗户：

{
  "mcpServers": {
    "dbeaver-mcp": {
      "command": "cmd",
      "args": ["/c", "C:\\path\\to\\dbeaver-mcp-windows\\run.bat"]
    }
  }
}

将路径替换为提取存档的实际路径。

______________________________________________________________________

3.验证

配置后，您可以通过要求您的AI工具列出可用的数据库连接来验证连接。例如：

List my available database connections.

可用工具

服务器公开了两个MCP工具：

配置

默认情况下，服务器从操作系统的标准位置读取DBeaver的配置文件：

如果DBeaver配置位于其他位置，则可以通过向启动器脚本传递参数来覆盖路径：

./run.sh --dbeavermcp.dbeaver.config.data-sources-file-path=/custom/path/data-sources.json \
         --dbeavermcp.dbeaver.config.credentials-config-file-path=/custom/path/credentials-config.json

要通过MCP配置传递这些参数，请将它们添加到命令args中。例如，在Claude Code中：

claude mcp add --scope user --transport stdio dbeaver-mcp -- /path/to/run.sh \
  --dbeavermcp.dbeaver.config.data-sources-file-path=/custom/path/data-sources.json

或者在Gemini CLI中(~/.gemini/settings.json):

{
  "mcpServers": {
    "dbeaver-mcp": {
      "command": "/path/to/dbeaver-mcp-linux/run.sh",
      "args": [
        "--dbeavermcp.dbeaver.config.data-sources-file-path=/custom/path/data-sources.json"
      ]
    }
  }
}

从源头构建

要求：Java 25。

cd dbeaver-mcp
./gradlew bootJar

输出罐将位于 dbeaver-mcp/build/libs/dbeaver-mcp.jar.