JDBC Database Connector

🚀 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 的發展貢獻力量。