Adx MCP Server

🚀 Azure 數據探索者 MCP 服務器

這是一個支持 Model Context Protocol（MCP）協議的 Azure 數據探索者（Azure Data Explorer）服務器。它提供了對 Azure 數據探索者集群和數據庫的標準 MCP 接口訪問，讓 AI 助手能夠執行 KQL 查詢並探索數據。

🚀 快速開始

前提條件

• 使用 Azure CLI 登錄到擁有 ADX 集群權限的 Azure 賬戶。
• 通過 .env 文件或系統環境變量配置環境變量，以指定您的 ADX 集群：

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

配置客戶端

將服務器配置添加到客戶端配置文件中。例如，對於 Claude 桌面版：

{
  "mcpServers": {
    "adx": {
      "command": "uv",
      "args": [
        "--directory",
        "<您的 adx-mcp-server 目錄完整路徑>",
        "run"
      ],
      "environment": {
        "ADX_CLUSTER_URL": "https://yourcluster.region.kusto.windows.net",
        "ADX_DATABASE": "your_database"
      }
    }
  }
}

✨ 主要特性

• [x] 執行針對 Azure 數據探索者的 KQL 查詢
• [x] 發現和探索數據庫資源
  • [x] 列出配置的數據庫中的表
  • [x] 查看錶架構
  • [x] 獲取表樣例數據（可選指定樣本數量）
• [x] 支持身份驗證
  • [x] 令牌憑證支持（Azure CLI、MSI 等）
• [x] Docker 容器化支持
• [x] 提供交互式工具以供 AI 助手使用

工具列表是可配置的，因此您可以選擇要對 MCP 客戶端開放哪些工具。這對於您不使用某些功能或不想佔用過多上下文窗口的情況非常有用。

📦 安裝指南

Docker 支持

通過以下命令構建和運行容器：

# 建構 Docker 鏡像
docker build -t adx-mcp-server .

# 運行容器
docker run --name adx-mcp-server -p 8000:8000 adx-mcp-server

在 Claude 桌面版中配置服務器 URL 如下：

{
  "mcpServers": {
    "adx": {
      "url": "http://localhost:8000"
    }
  }
}

💻 使用示例

基礎用法

按照上述快速開始的步驟完成配置後，AI 助手即可通過 MCP 接口對 Azure 數據探索者執行 KQL 查詢等操作。

📚 詳細文檔

工具列表

項目結構

.
├── src/
│   ├── server.py          # MCP 服務器實現
│   └── main.py           # 主應用邏輯
├── Dockerfile            # Docker 配置文件
├── docker-compose.yml    # Docker Compose 配置
├── .dockerignore         # Docker 忽略文件
├── pyproject.toml        # 項目配置文件
└── README.md             # 本文件

測試

項目包含全面的測試套件，以確保功能並防止迴歸。 運行測試：

# 安裝開發依賴項
uv pip install -e ".[dev]"

# 運行測試
pytest

# 生成覆蓋率報告
pytest --cov=src --cov-report=term-missing

📄 許可證

本項目採用 MIT 許可證。