JinDaGe - JDBC Database Connector MCP Details

article

README

🚀 MCP - JDBC - Server

MCP - JDBC - Server 是一个实现了 Model Context Protocol (MCP) 的项目，它支持通过 JDBC 接口进行数据库操作，还集成了 AI 助手功能。该项目能帮助用户更便捷地与数据库交互，特别是在使用 Virtuoso 数据库时，可发挥其特定功能优势。

🚀 快速开始

MCP - JDBC - Server 是一个实现了 Model Context Protocol (MCP) 的项目，支持通过 JDBC 接口进行数据库操作以及集成 AI 助手功能。下面为你介绍如何快速开启使用。

📦 安装指南

1. 下载 MCP - JDBC - Server

从 GitHub 下载最新版本的 MCP - JDBC - Server，并解压到本地目录。

2. 安装依赖

确保已安装以下软件：

JDK 8 或更高版本：用于运行 Java 程序。
Maven：用于管理项目依赖和构建。
Node.js 和 npm：用于运行 MCP 组件（如 Inspector）。

3. 配置环境变量

设置以下环境变量以确保项目顺利运行：

JAVA_HOME：指向 JDK 的安装目录。
PATH：包含 Node.js 和 Maven 的可执行文件路径。

💻 使用示例

基础用法

1. 启动 MCP - JDBC - Server

在终端中运行以下命令启动服务器：

java -jar mcp-jdbc-server-1.0.0-runner.jar

2. 配置数据库连接

编辑 config.properties 文件，配置数据库连接信息（如 JDBC URL、用户名和密码）。

3. 使用 MCP 组件

通过以下命令安装并运行 MCP Inspector 进行调试：

npm install -g @modelcontextprotocol/inspector
npx @modelcontextprotocol/inspector java -jar mcp-jdbc-server-1.0.0-runner.jar

访问提供的 URL 地址，即可查看服务器交互信息。

代码示例

基本 JDBC 操作

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;

public class MCPJDBCExample {
    public static void main(String[] args) {
        String url = "jdbc:mysql://localhost:3306/mydatabase";
        String user = "root";
        String password = "password";

        try {
            Connection connection = DriverManager.getConnection(url, user, password);
            PreparedStatement statement = connection.prepareStatement("SELECT * FROM mytable");
            ResultSet result = statement.executeQuery();

            while (result.next()) {
                System.out.println(result.getString(1));
            }

            connection.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

AI 助手调用

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.CallableStatement;
import java.sql.SQLException;

public class AIAssistantExample {
    public static void main(String[] args) {
        String url = "jdbc:mysql://localhost:3306/mydatabase";
        String user = "root";
        String password = "password";

        try {
            Connection connection = DriverManager.getConnection(url, user, password);
            CallableStatement statement = connection.prepareCall("{?=CALL DEMO.DBA.OAI_VIRTUOSO_SUPPORT_AI(?)}");
            
            String prompt = "Please explain quantum computing.";
            statement.setString(2, prompt);

            statement.execute();
            ResultSet result = statement.getResultSet();

            while (result.next()) {
                System.out.println(result.getString(1));
            }

            connection.close();
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }
}

✨ 主要特性

数据库操作

MCP - JDBC - Server 提供标准的 SQL 操作功能，包括：

查询数据：执行 SELECT 语句并返回结果。
更新数据：执行 INSERT、UPDATE 和 DELETE 语句。
事务管理：支持显式事务控制。

AI 助手集成

通过 Virtuoso 数据库的特定函数，MCP - JDBC - Server 集成了 AI 助手功能：

SPASQL 查询：混合 SQL 和 SPARQL 进行复杂数据分析。
SPARQL 支持：直接执行 SPARQL 语句并获取结果。
AI 支持：利用 Virtuoso 的 AI 助手函数，通过 API Key 提供智能查询功能。

📚 详细文档

常见问题

1. 无法启动服务器

解决方法：检查环境变量配置是否正确，确保 JDK 和 Maven 已正确安装。

2. 数据库连接失败

解决方法：验证数据库 URL、用户名和密码是否正确，并确保数据库服务已运行。

3. AI 助手功能异常

解决方法：检查 API Key 是否有效，并确认 Virtuoso 数据库的 AI 函数已启用。

贡献指南

欢迎贡献代码或文档！请 Fork 本仓库并提交 Pull Request，为 MCP - JDBC - Server 的发展贡献力量。

JDBC Database Connector