MSSQL Database Manager

🚀 MSSQL MCP 服務器

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

🚀 快速開始

MSSQL MCP 服務器為與 MSSQL 數據庫的交互提供了安全且結構化的方式。以下是使用該服務器的基本步驟：

1. 安裝服務器。
2. 配置數據庫訪問。
3. 根據需求集成到 Claude Desktop 或作為獨立服務器運行。

✨ 主要特性

• 安全訪問：通過環境變量實現對 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 安全配置指南。

⚠️ 重要提示

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

📄 許可證

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

🤝 貢獻

我們歡迎貢獻！要進行貢獻，請按照以下步驟操作：

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。

需要幫助？

對於任何問題或疑問，請聯繫 此處。