Pab1it0 Adx MCP Server

🚀 Azure 數據探索器 MCP 服務器

Azure 數據探索器 MCP 服務器基於標準化的 模型上下文協議 (MCP) 接口，可幫助您輕鬆訪問 Azure 數據探索集群和數據庫。同時，它還允許 AI 助手執行 KQL 查詢，高效探索數據。

🚀 快速開始

前提條件

• 使用 Azure CLI 登錄到擁有 Azure 數據探索器集群權限的 Azure 帳戶。

環境配置

通過 .env 文件或系統環境變量配置環境變量：

# 必填：Azure 數據探索器配置
ADX_CLUSTER_URL=https://yourcluster.region.kusto.windows.net
ADX_DATABASE=your_database

客戶端配置

將服務器配置添加到您的客戶端配置文件中。例如，對於 Claude Desktop：

{
  "mcpServers": {
    "adx": {
      "command": "uv",
      "args": [
        "--directory",
        "<完整路徑到 adx-mcp-server 文件夾>",
      ],
    },
  },
}

✨ 主要特性

• KQL 查詢執行：支持執行針對 Azure 數據探索器的 KQL 查詢。
• 數據庫資源探索：可發現並探索數據庫資源，具體包括：
  • 列出配置數據庫中的表。
  • 查看錶結構。
  • 獲取表樣例數據。
• 身份驗證支持：支持令牌憑證（如 Azure CLI、MSI 等）。
• 容器化支持：提供 Docker 容器化支持。
• 交互式工具：提供交互式工具以供 AI 助手使用，且工具列表可配置，您可以按需選擇要向 MCP 客戶端提供的工具，避免佔用過多上下文窗口空間。

📦 安裝指南

Docker 支持

• 構建鏡像：使用以下命令構建 Docker 鏡像：

docker build -t azure-data-explorer-mcp .

• 運行容器：使用以下命令運行 Docker 容器：

docker run --rm -it -e ADX_CLUSTER_URL=your_cluster_url -e ADX_DATABASE=your_database azure-data-explorer-mcp

💻 使用示例

基礎用法

通過配置好的環境和客戶端，即可使用 AI 助手通過 MCP 接口執行 KQL 查詢等操作，探索 Azure 數據探索器中的數據。

高級用法

根據不同的業務需求，您可以靈活配置工具列表，選擇向 MCP 客戶端提供的工具，以滿足特定場景下的使用需求。

📚 詳細文檔

工具詳情

📄 許可證

本項目採用 MIT 許可證。