Azure Data Explorer MCP Server

Azure Data Explorer MCP 服务

这是一个 Model Context Protocol（MCP）服务，可登录 Azure Data Explorer 并运行 KQL 查询。

功能

• 使用服务主体（客户端凭据）登录 Azure Data Explorer
• 对 Azure Data Explorer 数据库运行 KQL 查询
• 查看格式化后的查询结果

前提条件

• Node.js（v16 或更高版本）
• npm（v7 或更高版本）
• Azure Data Explorer 集群
• 有权访问 Azure Data Explorer 的服务主体

设置

1. 克隆或下载此代码库
2. 安装依赖项：

npm install

3. 构建项目：

npm run build

运行服务

启动服务：

npm start

服务将通过标准输入/输出（stdio）进行监听，这是 Claude for Desktop 等 MCP 客户端所需的格式。

在 Claude for Desktop 中使用

1. 编辑 claude_desktop_config.json 文件，将此 MCP 服务配置为 Claude for Desktop 的服务：

{
  "mcpServers": {
    "adx-query-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/this/repository/build/index.js"
      ]
    }
  }
}

2. 重启 Claude for Desktop

3. 通过 Claude 使用 MCP 服务，请求其：

   • 登录 Azure Data Explorer
   • 运行 KQL 查询

可用工具

login-to-adx

使用客户端凭据对 Azure Data Explorer 进行身份验证。

参数：

• cluster：ADX 集群 URL（例如，https://mycluster.eastus.kusto.windows.net）
• database：数据库名称
• tenantId：Azure 租户 ID
• clientId：Azure 客户端/应用程序 ID
• clientSecret：Azure 客户端密钥

run-adx-query

对已连接的 Azure Data Explorer 数据库运行 KQL 查询。

参数：

• query：要执行的 KQL 查询

开发

在开发模式下运行服务：

npm run dev

许可证

ISC