Sql MCP

🚀 SQL MCP 服務器

SQL MCP 服務器 是一個統一的代理接口，它允許 AI 模型（如 Claude）通過一套單一、標準化的工具來檢查、查詢和與多種類型的數據庫進行交互。

無需為 MySQL、SQL Server、Oracle 等分別安裝和配置服務器，這個單一的軟件包可以根據你的配置動態加載正確的“適配器”，從而處理所有這些數據庫。

🚀 快速開始

SQL MCP 服務器提供了一個統一的方式讓 AI 模型與多種數據庫交互。你可以通過克隆倉庫、創建虛擬環境、安裝依賴以及配置環境變量來啟動使用。

✨ 主要特性

• 標準化工具集：無論 AI 是與 Oracle 還是 MySQL 進行交互，它始終使用相同的工具（execute_query、describe_table、get_db_version）。這減少了錯誤信息的產生，並提高了查詢的準確性。
• 資源管理：自動將數據庫表作為 MCP 資源公開，便於檢查。
• 智能適配器：
  • ✅ MySQL：使用 mysql-connector-python 並支持連接池。
  • ✅ MSSQL：使用 pymssql 並自動檢測模式名稱（例如 dbo.Users）。
  • ✅ Sybase / SAP IQ：使用 pyodbc 並智能處理 dba. 前綴和服務器名稱。
  • ✅ Oracle：使用 oracledb（瘦模式），無需複雜的驅動程序安裝即可輕鬆連接。
• 支持 Unicode：所有連接默認使用 UTF - 8 編碼，可無縫處理特殊字符。

📦 安裝指南

1. 克隆倉庫：

   git clone https://github.com/BryR0/sql-mcp.git
   cd sql-mcp
   

2. 創建虛擬環境：

   python -m venv venv
   source venv/bin/activate  # 在 Windows 上：.\venv\Scripts\activate
   

3. 安裝依賴：

   pip install -e .
   

📚 詳細文檔

⚙️ 配置

你可以通過 DB_TYPE 環境變量來指定要使用的數據庫。

支持的環境變量

Claude 桌面配置示例

將以下內容添加到你的 claude_desktop_config.json 中。請注意，DB_PORT 是可選的，如果省略，將默認為所選數據庫類型的標準端口。

{
  "mcpServers": {
    "sql_mcp_mysql": {
      "command": "C:\\path\\to\\venv\\python.exe",
      "args": ["-m", "sql_mcp"],
      "env": {
        "DB_TYPE": "mysql",
        "DB_HOST": "localhost",
        "DB_USER": "root",
        "DB_PASSWORD": "password",
        "DB_DATABASE": "my_db"
      }
    },
    "sql_mcp_mssql": {
      "command": "C:\\path\\to\\venv\\python.exe",
      "args": ["-m", "sql_mcp"],
      "env": {
        "DB_TYPE": "mssql",
        "DB_HOST": "192.168.1.50",
        "DB_USER": "sa",
        "DB_PASSWORD": "password",
        "DB_DATABASE": "DataWarehouse"
      }
    }
  }
}

🏗️ 架構

該項目使用 適配器模式：

1. 服務器 接收請求（例如 execute_query）。
2. 工廠 檢查 DB_TYPE 並實例化正確的類（例如 MSSQLAdapter）。
3. 適配器 將通用請求轉換為特定驅動程序調用（pymssql、pyodbc 等）。
4. 響應 被格式化為標準的 JSON 結構供 AI 使用。

這意味著你只需更改配置，而無需更改 AI 的提示或邏輯，就可以切換數據庫。

📄 許可證

本項目採用 MIT 許可證。有關詳細信息，請參閱 LICENSE 文件。