Microsoft SQL Server (MSSQL)

🚀 微軟SQL Server MCP服務器

微軟SQL Server MCP服務器是一個模型上下文協議（MCP）服務器，可用於安全地與微軟SQL Server數據庫進行交互。它允許AI助手列出表格、讀取數據並執行帶有適當錯誤處理的SQL查詢，通過受控接口進行數據庫探索和分析，使整個過程更加安全且結構化。

🚀 快速開始

本服務器可讓AI助手安全地與微軟SQL Server數據庫交互，實現表格列出、數據讀取及SQL查詢執行等功能。

✨ 主要特性

• 🔖 列出可用的SQL Server表作為資源。
• 📖 讀取表內容。
• 🛠️ 執行SQL查詢並進行適當錯誤處理。
• 🔐 通過環境變量實現數據庫的安全訪問。
• 📝 全面日誌記錄。
• ⚙️ 自動系統依賴安裝。

📦 安裝指南

通過MCP安裝時會自動安裝所需的系統依賴（如FreeTDS）：

pip install mssql-mcp-server

📚 詳細文檔

配置

設置以下環境變量：

MSSQL_SERVER=localhost
MSSQL_USER=your_username
MSSQL_PASSWORD=your_password
MSSQL_DATABASE=your_database

使用方法

與Claude桌面配合使用

將以下內容添加到claude_desktop_config.json中：

{
  "mcpServers": {
    "mssql": {
      "command": "uv",
      "args": [
        "--directory", 
        "path/to/mssql_mcp_server",
        "run",
        "mssql_mcp_server"
      ],
      "env": {
        "MSSQL_SERVER": "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/RichardHan/mssql_mcp_server.git
cd mssql_mcp_server

# 創建虛擬環境
python -m venv venv
source venv/bin/activate  # 或 `venv\Scripts\activate` 在Windows上

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

# 運行測試
pytest

安全注意事項

⚠️ 重要提示

• 永遠不要提交環境變量或憑證。
• 使用權限最小的數據庫用戶。
• 考慮在生產環境中實現查詢白名單。
• 監控和記錄所有數據庫操作。

安全最佳實踐

此MCP服務器需要數據庫訪問權限才能運行。出於安全考慮：

1. 創建一個專用的SQL Server登錄，具有最小的權限。
2. 不要使用sa憑證或管理帳戶。
3. 限制數據庫訪問為僅必需的操作。
4. 啟用日誌記錄用於審核目的。
5. 定期進行安全審查數據庫訪問。

請參閱SQL Server安全配置指南獲取詳細說明，包括如何：

• 創建受限的SQL Server登錄。
• 設置適當的權限。
• 監控數據庫訪問。
• 安全最佳實踐。

⚠️ 重要提示

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

📄 許可證

本項目採用MIT許可證 - 請參閱LICENSE文件以獲取詳細信息。

💪 貢獻

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