Azure Data Explorer查询服务

一个基于Model Context Protocol (MCP)的服务,用于登录Azure Data Explorer并执行KQL查询。

  • by cheng306
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 cheng306/mcp-server

使用说明

Azure数据资源管理器MCP服务器

这是一个模型上下文协议(MCP)服务器,可以登录Azure数据资源管理器并运行KQL查询。

特性

  • 使用服务主体(客户端凭据)登录Azure数据资源管理器
  • 对Azure数据资源管理器数据库运行KQL查询
  • 查看格式化查询结果

先决条件

  • Node.js(v16或更高版本)
  • npm(v7或更高版本)
  • Azure数据资源管理器群集
  • 具有Azure数据资源管理器访问权限的服务主体

设置

  1. 克隆或下载此存储库
  2. 安装依赖项:
npm install
  1. 构建项目:
npm run build

运行服务器

启动服务器:

npm start

服务器将监听标准输入/输出(stdio),这是像Claude for Desktop这样的MCP客户端所期望的格式。

使用Claude for Desktop

  1. 通过编辑配置Claude for Desktop以使用此MCP服务器 claude_desktop_config.json 文件:
{
  "mcpServers": {
    "adx-query-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/this/repository/build/index.js"
      ]
    }
  }
}
  1. 重新启动桌面版的Claude

  2. 通过Claude使用MCP服务器,要求它:

    • 登录Azure数据资源管理器
    • 运行KQL查询

可用工具

登录adx

使用客户端凭据通过Azure数据资源管理器进行身份验证。

参数:

  • cluster:ADX集群URL(例如。,https://mycluster.eastus.kusto.windows.net)
  • database:数据库名称
  • tenantId:Azure租户ID
  • clientId:Azure客户端/应用程序ID
  • clientSecret:Azure客户端秘密

运行adx查询

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

参数:

  • query:要执行的KQL查询

发展

要在开发模式下运行服务器,请执行以下操作:

npm run dev

许可证

国际协调委员会