MCP Kql Server

🚀 MCP KQL Server

MCP KQL Server 是一個微軟雲平臺（MCP）服務器，可通過 Azure CLI 認證針對 Azure Data Explorer 執行 KQL 查詢，為數據查詢提供便捷途徑。

🚀 快速開始

安裝

1. 確保已安裝 uv：

   pip install uv
   

2. 設置虛擬環境並安裝依賴項：

   uvx venv
   source .venv/bin/activate  # 在 Windows 上使用：.venv\Scripts\activate
   uvx pip install .
   

啟動服務器

使用以下命令啟動服務器：

uvx run start

服務器將在 http://0.0.0.0:5000 上可用。

💻 使用示例

基礎用法

認證

curl -X POST http://localhost:5000/auth

執行 KQL 查詢

curl -X POST http://localhost:5000/execute \
       -H "Content-Type: application/json" \
       -d '{"query": "cluster('\''mycluster'\'').database('\''mydb'\'').MyTable | take 10"}'

📚 詳細文檔

與 Claude Desktop 集成

在 claude_desktop_config.json 中配置服務器，以在 Claude Desktop 中啟用 kql_execute 工具。工具詳細信息請參閱 mcp_config.yaml。

🔧 技術細節

系統要求

• Python 3.9
• 用於認證的 Azure CLI (az)
• 依賴項：Flask、waitress、azure-kusto-data、tenacity

故障排除

• 確保已通過 Azure CLI 進行認證：az login
• 檢查服務器日誌以查找錯誤。
• 驗證端口 5000 已開放且可訪問。