Mssql MCP Server

🚀 Microsoft SQL Server 的 MCP 服務器

MSSQL MCP 服務器基於 Model Context Protocol (MCP)，旨在實現與 Microsoft SQL Server (MSSQL) 數據庫安全且結構化的交互。它允許 AI 助手執行列出可用表、讀取表格內容、執行受控訪問的 SQL 查詢等操作，確保了更安全的數據庫探索、嚴格的權限執行和對數據庫交互的日誌記錄。

🚀 快速開始

MSSQL MCP 服務器能讓 AI 助手與 MSSQL 數據庫進行安全交互，可執行多種數據庫操作，保障數據庫使用的安全性和規範性。

✨ 主要特性

• 安全訪問：通過環境變量實現 MSSQL 數據庫的安全訪問。
• 受控執行：支持受控查詢執行，並帶有錯誤處理機制。
• 數據檢索：可進行表目錄及數據檢索。
• 全面日誌：具備全面日誌記錄功能，用於監控查詢和操作。

📦 安裝指南

使用以下命令安裝 mssql-mcp-server：

pip install mssql-mcp-server

📚 詳細文檔

配置

設置以下環境變量以配置數據庫訪問：

MSSQL_DRIVER=mssql_driver
MSSQL_HOST=localhost
MSSQL_USER=your_username
MSSQL_PASSWORD=your_password
MSSQL_DATABASE=your_database
# 可選
TrustServerCertificate=yes
Trusted_Connection=no

使用方法

與 Claude Desktop 集成

要與 Claude Desktop 集成，請將以下配置添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "mssql": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/mssql_mcp_server",
        "run",
        "mssql_mcp_server"
      ],
      "env": {
        "MSSQL_DRIVER": "mssql_driver",
        "MSSQL_HOST": "localhost",
        "MSSQL_USER": "your_username",
        "MSSQL_PASSWORD": "your_password",
        "MSSQL_DATABASE": "your_database"
      }
    }
  }
}

作為獨立服務器運行

# 安裝依賴項
pip install -r requirements.txt

# 啟動服務器
python -m mssql_mcp_server

開發

# 克隆倉庫
git clone https://github.com/yourusername/mssql_mcp_server.git
cd mssql_mcp_server

# 設置虛擬環境
python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

# 安裝開發依賴項
pip install -r requirements-dev.txt

# 運行測試
pytest

安全注意事項

• 使用具有最小權限的 專用 MSSQL 用戶。
• 絕對不要使用根憑據或完全管理帳戶。
• 僅限於必要的操作，限制數據庫訪問。
• 啟用日誌記錄和監控以進行安全審計。
• 定期審查權限 以確保最少權限訪問。

安全最佳實踐

為實現安全配置：

1. 創建一個具有受限權限的 專用 MSSQL 用戶。
2. 避免硬編碼憑據，改用環境變量。
3. 僅授予必要的表和操作訪問權限。
4. 啟用 SQL Server 日誌記錄和監控以進行審計。
5. 定期審查數據庫訪問權限以防止未授權訪問。

有關詳細說明，請參閱 MSSQL 安全配置指南。

⚠️ 重要提示

始終遵循 最小特權原則 進行數據庫訪問配置。

貢獻

我們歡迎貢獻！要進行貢獻：

1. 叉倉庫。
2. 創建功能分支：git checkout -b feature/amazing-feature
3. 提交更改：git commit -m 'Add amazing feature'
4. 推送到分支：git push origin feature/amazing-feature
5. 打開一個 Pull Request。

需要幫助？

對於任何問題或疑問，請隨意打開 GitHub 上的 Issue 或聯繫維護者。

📄 許可證

此項目根據 MIT License 發佈。有關詳細信息，請參閱 LICENSE 文件。