OpenLink MCP Server для JDBC

Легкий Java-сервер MCP (Model Context Protocol) для JDBC, построенный с помощью Quakrus. Этот сервер совместим с Virtuoso DBMS и любым другим сервером DBMS с драйвером JDBC.

Особенности

Получить схемы: Получить и перечислить все имена схем из подключенной базы данных. Get Tables: Получите информацию о таблицах для конкретных схем или всех схем. Опишите таблицу: Создайте подробное описание структур таблиц, в том числе: Названия колонок и типы данных

• Нулевые атрибуты Первичные и иностранные ключи ** Таблицы поиска**: Фильтруйте и извлекайте таблицы на основе подстрок имени. Исполнить хранимые процедуры: Виртуозная особенность! Выполняйте сохраненные процедуры и извлекайте результаты. Исполнить запросы: Формат результатов JSONL: оптимизирован для структурированных ответов. Формат таблицы разметки: Идеально подходит для отчетности и визуализации.

Предпосылки

MCP-сервер требует Java 21 или выше.

##Установка

Клонируйте это хранилище:

Переменные среды

Обновите свой .env, переопределив эти по умолчанию, чтобы соответствовать вашим предпочтениям:

Конфигурация

---

OpenLink MCP Server for JDBC

A lightweight Java-based MCP (Model Context Protocol) server for JDBC built with Quakrus. This server is compatible with Virtuoso DBMS and any other DBMS backend that has a JDBC driver.

---

Features

• Get Schemas: Fetch and list all schema names from the connected database.
• Get Tables: Retrieve table information for specific schemas or all schemas.
• Describe Table: Generate a detailed description of table structures, including:
  • Column names and data types
  • Nullable attributes
  • Primary and foreign keys
• Search Tables: Filter and retrieve tables based on name substrings.
• Execute Stored Procedures: A Virtuoso-specific feature! Execute stored procedures and retrieve results.
• Execute Queries:
  • JSONL result format: Optimized for structured responses.
  • Markdown table format: Ideal for reporting and visualization.

---

Prerequisites

MCP server requires Java 21 or above.

---

Installation

Clone this repository:

git clone https://github.com/OpenLinkSoftware/mcp-jdbc-server.git  
cd mcp-jdbc-server

Environment Variables

Update your .env by overriding these defaults to match your preferences:

jdbc.url=jdbc:virtuoso://localhost:1111
jdbc.user=dba
jdbc.password=dba
jdbc.api_key=xxx

---

Configuration

For Claude Desktop users using Virtuoso and its JDBC driver:

Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "my_database": {
      "command": "java",
      "args": ["-jar", "/path/to/mcp-jdbc-server/MCPServer-1.0.0-runner.jar"],
      "env": {
        "jdbc.url": "jdbc:virtuoso://localhost:1111",
        "jdbc.user": "username",
        "jdbc.password": "password",
        "jdbc.api_key": "sk-xxx"
      }
    }
  }
}

For Claude Desktop users using another JDBC driver or a combination of drivers:

Add the following, edited to suit your local environment, to claude_desktop_config.json:

    "jdbc": {
      "command": "java",
      "args": [
        "-cp",
        "/path/to/mcp-jdbc-server/MCPServer-1.0.0-runner.jar:/path/to/jdbc_driver1.jar:/path/to/jdbc_driverN.jar",
        "io.quarkus.runner.GeneratedMain"
      ],
      "env": {
        "jdbc.url": "jdbc:virtuoso://localhost:1111",
        "jdbc.user": "dba",
        "jdbc.password": "dba"
      }
    }

---

Use

Tools Provided

After successful installation, the following tools will be available to MCP client applications.

Overview