Dbeaver Mcp

DBeaver MCP

An MCP (Model Context Protocol) server that connects AI tools to your databases through DBeaver. It reads your existing DBeaver connection configurations and lets you run read-only SQL queries directly from AI assistants like Claude Code and Gemini CLI.

Built with Spring Boot and Spring AI. Communicates via STDIO.

Supported Databases

| Database | Compatibility | Driver | |------------|---------------|----------------| | PostgreSQL | Any version | org.postgresql | | Oracle | 11+ | ojdbc11 | | Firebird | 2.5+ | Jaybird 6 |

Limitations

• SSH: password authentication only. Connections that use SSH key-based authentication (public/private key) are not supported and will be automatically filtered out. Only SSH connections configured with password authentication in DBeaver will work.
• Read-only queries only. All queries run inside a read-only transaction that is always rolled back. No data can be modified.
• DBeaver connections only. The server discovers databases from DBeaver's configuration files. You cannot provide manual connection strings.

Getting Started

Prerequisites

• DBeaver installed with at least one database connection configured.
• No Java installation required - the launcher scripts automatically download a JRE on first run.

1. Download

Go to the Releases page and download the archive for your platform:

• Linux: dbeaver-mcp-linux.tar.gz
• Windows: dbeaver-mcp-windows.zip

Extract the archive to a directory of your choice. It contains two files:

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

2. Add the MCP Server to Your AI Tool

Pick your tool below and follow the instructions.

---

Claude Code

Project scope (shared with your team via .mcp.json)

Linux:

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

Windows:

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

User scope (available across all your projects)

Linux:

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

Windows:

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

> Replace /path/to/ or C:\path\to\ with the actual path where you extracted the archive.

---

Gemini CLI

Add the server to your ~/.gemini/settings.json file. Create the file if it does not exist.

Linux:

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

Windows:

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

> Replace the paths with the actual path where you extracted the archive.

---

3. Verify

Once configured, you can verify the connection by asking your AI tool to list the available database connections. For example:

List my available database connections.

Available Tools

The server exposes two MCP tools:

| Tool | Description | |------------------------------|------------------------------------------------------------------------------------------------------------------------| | list_available_connections | Lists all database connections configured in DBeaver, including connection name, database type, URL, and SSH details. | | execute_read_only_query | Executes one or more read-only SQL statements against a named connection. Results are returned as rows of column/value maps. |

Configuration

By default, the server reads DBeaver's configuration files from the standard location for your operating system:

| OS | Default path | |---------|---------------------------------------------------------------------------| | Linux | ~/.local/share/DBeaverData/workspace6/General/.dbeaver/ | | macOS | ~/Library/DBeaverData/DBeaverData/workspace6/General/.dbeaver/ | | Windows | %APPDATA%\DBeaverData\workspace6\General\.dbeaver\ |

If your DBeaver configuration is in a different location, you can override the paths by passing arguments to the launcher script:

./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

To pass these arguments through an MCP configuration, add them to the command args. For example, in 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

Or in 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"
      ]
    }
  }
}

Building from Source

Requirements: Java 25.

cd dbeaver-mcp
./gradlew bootJar

The output jar will be at dbeaver-mcp/build/libs/dbeaver-mcp.jar.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: FelipeFlohr
• Source: FelipeFlohr/dbeaver-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.