MCP Kql Server

🚀 MCP KQL 服務器

MCP KQL 服務器是基於微軟雲平臺（MCP）構建的，它藉助 Azure CLI 身份驗證機制，能夠高效執行針對 Azure 數據探索者的 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 是否開放且可訪問。