Jexinsam Mssql MCP Server

🚀 MSSQL MCP 服務器

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

🚀 快速開始

MSSQL MCP 服務器提供了與 Microsoft SQL Server (MSSQL) 數據庫安全交互的功能。以下是快速上手的步驟：

安裝

pip install mssql-mcp-server

配置

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

MSSQL_DRIVERS=mssql_driver
MSSQL_HOST=localhost
MSSQL_USER=your_username
MSSQL_PASSWORD=your_password
MSSQL_DATABASE=your_database

✨ 主要特性

• 安全訪問：通過環境變量實現對 MSSQL 數據庫的安全訪問。
• 受控查詢：帶有錯誤處理的受控查詢執行。
• 數據檢索：具備表列表及數據檢索功能。
• 全面監控：提供全面日誌記錄以進行監控。

💻 使用示例

與 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 用戶。
• 絕對不要使用 root 賬戶或擁有完全管理權限的賬戶。
• 限制數據庫訪問，僅允許必要的操作。
• 對數據庫交互進行全面日誌記錄。

最佳實踐

1. 創建專用用戶：始終為數據庫交互創建一個具有最小權限的專用用戶，而不是使用管理員賬戶。
2. 避免硬編碼憑據：不要在代碼中直接寫入密碼。可以考慮使用環境變量或安全的秘密管理工具。
3. 啟用日誌記錄和監控：對所有數據庫活動進行日誌記錄，並設置監控以檢測異常行為。
4. 定期審查權限：定期檢查並更新用戶的訪問權限，確保沒有未使用的權限殘留。
5. 備份數據：定期備份數據庫以防萬一。

📄 許可證

項目使用 MIT License。有關詳細信息，請參閱 LICENSE 文件。

🤝 貢獻指南

要為該項目做出貢獻，請按照以下步驟操作：

1. Fork 倉庫到您自己的 GitHub 賬戶。
2. 創建功能分支用於您的更改：git checkout -b feature/your-feature-name
3. 提交您的更改：git commit -m '描述您的更改'
4. 推送到分支機構：git push origin feature/your-feature-name
5. 打開 Pull Request 到主要分支。

❓ 幫助

如果您有任何問題或需要幫助，請隨時通過 GitHub Issues 提交問題，或者聯繫項目維護人員。