MCPgee
MCPgee
MCPgeeMCPgee

MCP JDBC

v1.0.0•Databases•stable

☕ 🏠 - A filesystem allowing for browsing and editing files implemented in Java using Quarkus. Available as jar or native image.

mcpquarkus-app
Share:
191
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is MCP JDBC?

MCP JDBC is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ☕ 🏠 - a filesystem allowing for browsing and editing files implemented in java using quarkus. available as jar or native image.

☕ 🏠 - A filesystem allowing for browsing and editing files implemented in Java using Quarkus. Available as jar or native image.

This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • ☕ 🏠 - A filesystem allowing for browsing and editing files i

Use Cases

Browse and edit files through a filesystem interface using Java.
Provide MCP server implementation with Quarkus.
Enable cross-database compatibility with JDBC.
quarkiverse

Maintainer

LicenseApache 2.0
Languagejava
Versionv1.0.0
UpdatedMay 13, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx mcp-jdbc

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCP JDBC

The mcp-jdbc server is part of the Quarkus MCP Servers collection and provides AI assistants with direct SQL access to any JDBC-compatible database, including PostgreSQL, MySQL, Oracle, and SQLite, through a single MCP interface. Built on Quarkus and distributed as a native binary or JVM JAR via jbang, it exposes database browsing, schema inspection, and query execution tools so agents can retrieve, insert, or update records without requiring a custom database connector. Java developers and data engineers use it to let Claude or other AI agents run analytical queries and database management tasks directly against their SQL databases.

Prerequisites

  • Java 17+ JDK installed, or use the native binary without a JVM
  • jbang installed (or available via `npx @jbangdev/jbang`)
  • A JDBC-compatible database running and network-accessible
  • Valid JDBC connection URL with credentials
  • An MCP client such as Claude Desktop
1

Install jbang

jbang is the primary launcher. Install it globally or use it ad-hoc via npx without a global install.

# Global install via curl
curl -Ls https://sh.jbang.dev | bash -s - app setup

# Or via npm without installing
npx @jbangdev/jbang jdbc@quarkiverse/quarkus-mcp-servers <jdbc-url>
2

Test the JDBC server from your terminal

Run the JDBC MCP server directly to confirm it connects to your database before configuring your MCP client.

jbang jdbc@quarkiverse/quarkus-mcp-servers jdbc:postgresql://localhost:5432/mydb?user=admin&password=secret
3

Configure Claude Desktop to use the JDBC server

Add the JDBC server to your claude_desktop_config.json with your database connection URL as the argument.

{
  "mcpServers": {
    "mcp-jdbc": {
      "command": "jbang",
      "args": [
        "jdbc@quarkiverse/quarkus-mcp-servers",
        "jdbc:postgresql://localhost:5432/mydb?user=admin&password=secret"
      ]
    }
  }
}
4

Restart Claude Desktop

Quit and relaunch Claude Desktop to load the new JDBC MCP server. On first run, jbang will download server dependencies which may take up to a minute.

5

Verify connectivity with a schema query

Ask Claude to list the tables in your database to confirm the JDBC server is connected and working correctly.

MCP JDBC Examples

Client configuration

Claude Desktop config for the mcp-jdbc server connecting to a PostgreSQL database

{
  "mcpServers": {
    "mcp-jdbc": {
      "command": "jbang",
      "args": [
        "jdbc@quarkiverse/quarkus-mcp-servers",
        "jdbc:postgresql://localhost:5432/mydb?user=admin&password=yourpassword"
      ]
    }
  }
}

Prompts to try

Use these prompts once the JDBC server is connected to your database

- "List all tables in the database and their row counts"
- "Describe the schema of the 'users' table"
- "Show me the 10 most recently created records in the orders table"
- "How many records are in each table?"

Troubleshooting MCP JDBC

Connection refused or JDBC URL rejected

Verify the JDBC URL format for your database type. PostgreSQL uses `jdbc:postgresql://host:port/dbname`, MySQL uses `jdbc:mysql://host:port/dbname`. Test the URL in a standalone Java app or with jbang directly before adding it to the config.

Server starts but Claude cannot see database tools

Check that the jbang command in your MCP config uses the full path to jbang if Claude Desktop does not share your shell PATH. Run `which jbang` to find the full path.

First launch hangs or times out

jbang downloads JAR dependencies on the first run. Allow up to 60 seconds on slow connections. Subsequent starts are fast because jbang caches the artifacts locally.

Frequently Asked Questions about MCP JDBC

What is MCP JDBC?

MCP JDBC is a Model Context Protocol (MCP) server that ☕ 🏠 - a filesystem allowing for browsing and editing files implemented in java using quarkus. available as jar or native image. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCP JDBC?

Follow the installation instructions on the MCP JDBC GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCP JDBC?

MCP JDBC works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCP JDBC free to use?

Yes, MCP JDBC is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

MCP JDBC Alternatives — Similar Databases Servers

Looking for alternatives to MCP JDBC? Here are other popular databases servers you can use with Claude, Cursor, and VS Code.

Excelize

★ 20.6k

Go language library for reading and writing Microsoft Excel™ (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets

MCP Toolbox for Databases

★ 15.3k

Open source MCP server specializing in easy, fast, and secure tools for Databases.

DBHub

★ 2.8k

A universal database gateway MCP server that enables AI assistants to connect to and query multiple databases (PostgreSQL, MySQL, MariaDB, SQL Server, SQLite) with support for schema exploration, SQL execution, and secure connections via SSH tunnels.

Tabularis

★ 2.1k

A lightweight, cross-platform database client for developers. Supports MySQL, PostgreSQL and SQLite. Hackable with plugins. Built for speed, security, and aesthetics.

Postgres AI Guide

★ 1.7k

MCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.

Anyquery

★ 1.7k

🏎️ 🏠 ☁️ - Query more than 40 apps with one binary using SQL. It can also connect to your PostgreSQL, MySQL, or SQLite compatible database. Local-first and private by design.

Browse More Databases MCP Servers

Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

DatabasesBrowse All Servers

Quick Config Preview

{ "mcpServers": { "mcp-jdbc": { "command": "npx", "args": ["-y", "mcp-jdbc"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCP JDBC?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides