Rdb MCP Server

🚀 rdb-mcp-server

rdb-mcp-server 是一個基於Spring AI的實驗性MCP服務器，主要用於進行低級SQL操作。它藉助JDBC，通過stdio作為傳輸機制來實現功能。值得一提的是，該項目的原型由AI生成。

🚀 快速開始

本項目使用前需確保系統滿足相應的依賴條件，然後按照安裝、配置等步驟進行操作，即可開啟使用。

✨ 主要特性

• 多數據庫支持：支持MySQL、PostgreSQL和SQLite等多種數據庫。
• 靈活配置：可通過環境變量對數據庫連接、日誌文件路徑等進行靈活配置。
• 多種使用模式：支持獨立模式運行，也可與MCP客戶端集成。
• 豐富工具：提供 executeQuery、executeRawSql 和 executePreparedSql 等工具，滿足不同SQL操作需求。

📦 安裝指南

從GitHub發行頁面下載JAR文件。

💻 使用示例

配置

可用環境變量如下：

• DB_URL：數據庫連接URL（默認：jdbc:sqlite:./sqlite.db）
• DB_USER：數據庫用戶名
• DB_PASSWORD：數據庫密碼
• API_PASSWORD：非只讀操作的密碼（可選）
• LOG_FILE：日誌文件路徑（可選，默認：./rdb-mcp-server.log）

以獨立模式運行

java -jar x.x.x.jar

MCP客戶端集成

命令行界面

{
  "mcpServers": {
    "rdb_mcp_server": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/jar"
      ],
      "env": {
        "DB_URL": "jdbc:mysql://localhost:3306/your_database",
        "DB_USER": "your_username",
        "DB_PASSWORD": "your_password",
        "API_PASSWORD": "your_password_here",
        "LOG_FILE": "./rdb-mcp-server.log"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

光標

{
  "mcpServers": {
    "rdb_mcp_server": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/jar"
      ],
      "env": {
        "DB_URL": "jdbc:mysql://localhost:3306/your_database",
        "DB_USER": "your_username",
        "DB_PASSWORD": "your_password",
        "API_PASSWORD": "your_password_here",
        "LOG_FILE": "./rdb-mcp-server.log"
      }
    }
  }
}

📚 詳細文檔

可用工具

executeQuery

• 功能：執行只讀SQL查詢。
• 特點：無需身份驗證，但易受SQL注入攻擊。

executeRawSql

• 功能：執行原始SQL語句。
• 特點：需要密碼進行非只讀操作。

executePreparedSql

• 功能：使用PreparedStatement執行參數化SQL操作。

添加其他關係型數據庫

在 pom.xml 文件中添加適當的數據庫驅動程序並重新構建。

🔧 技術細節

本項目依賴Java 17或更高版本。它基於Spring AI構建，通過JDBC實現與數據庫的交互，使用stdio作為傳輸機制。在使用不同的工具時，根據工具的特點和需求，合理配置環境變量和進行身份驗證，以確保操作的安全性和正確性。例如，executeQuery 雖然無需身份驗證，但要注意防範SQL注入風險；executeRawSql 對於非只讀操作需要提供密碼進行身份驗證。