Azure Data Explorer MCP 服务器

Azure Data Explorer MCP 服务器

一个支持 AI 助手通过标准化接口查询和分析 Azure Data Explorer 数据库的 MCP 服务器。

快速入门

  1. 确保已安装 Azure CLI,并登录到有权访问 ADX 集群的账户。

  2. 配置环境变量(通过 .env 文件或系统环境变量):

    ADX_CLUSTER_URL=https://yourcluster.region.kusto.windows.net
    ADX_DATABASE=your_database
    
  3. 使用以下命令启动服务:

    uv run src/adx_mcp_server/main.py
    
  4. 或者使用 Docker:

    • 构建镜像:docker build -t adx-mcp-server .

    • 运行容器:

      docker run -it --rm \
        -e ADX_CLUSTER_URL=https://yourcluster.region.kusto.windows.net \
        -e ADX_DATABASE=your_database \
        adx-mcp-server
      
  5. 在客户端配置文件中添加服务器配置,例如 Claude Desktop:

    {
      "mcpServers": {
        "adx": {
          "command": "uv",
          "args": [
            "run",
            "src/adx_mcp_server/main.py"
          ],
          "env": {
            "ADX_CLUSTER_URL": "https://yourcluster.region.kusto.windows.net",
            "ADX_DATABASE": "your_database"
          }
        }
      }
    }
    
  6. 测试功能,如执行 KQL 查询、列出表结构等。