Azure Data Explorer MCP Server
Description
# Azure Data Explorer MCP Server This is a Model Context Protocol (MCP) server that can login to Azure Data Explorer and run KQL queries. ## Features - Login to Azure Data Explorer using service principal (client credentials) - Run KQL queries against an Azure Data Explorer…
About
# Azure Data Explorer MCP Server This is a Model Context Protocol (MCP) server that can login to Azure Data Explorer and run KQL queries. ## Features - Login to Azure Data Explorer using service principal (client credentials) - Run KQL queries against an Azure Data Explorer database - View formatted query results ##…
Details
- Author
- cheng306
- Downloads
- 207
- Categories
- Search
Jump to
- Login to Azure Data Explorer with client credentials
- Run KQL queries against an ADX database
- View formatted query results
- Works over stdio with any MCP client
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Azure Data Explorer MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, install dependencies (npm install), build (npm run build), and start (npm start). The server communicates via stdio. Configure it in Claude for Desktop by editing claude_desktop_config.json to point to the built index.js. Then ask Claude to login and run queries.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"azure data explorer mcp server": {
"adx-query-server": {
"command": "node",
"args": [
"/absolute/path/to/this/repository/build/index.js"
]
}
}
}
}McpServers
{
"adx-query-server": {
"command": "node",
"args": [
"/absolute/path/to/this/repository/build/index.js"
]
}
}Azure Data Explorer MCP Server
This is a Model Context Protocol (MCP) server that can login to Azure Data Explorer and run KQL queries.
Features
- Login to Azure Data Explorer using service principal (client credentials)
- Run KQL queries against an Azure Data Explorer database
- View formatted query results
Prerequisites
- Node.js (v16 or higher)
- npm (v7 or higher)
- Azure Data Explorer cluster
- Service Principal with access to Azure Data Explorer
Setup
1. Clone or download this repository
2. Install dependencies:
npm install
3. Build the project:
npm run build
Running the server
Start the server:
npm start
The server will listen on standard input/output (stdio), which is the format expected by MCP clients like Claude for Desktop.
Usage with Claude for Desktop
1. Configure Claude for Desktop to use this MCP server by editing the claude_desktop_config.json file:
{
"mcpServers": {
"adx-query-server": {
"command": "node",
"args": [
"/absolute/path/to/this/repository/build/index.js"
]
}
}
}
2. Restart Claude for Desktop
3. Use the MCP server through Claude by asking it to:
- Login to Azure Data Explorer
- Run KQL queries
Available Tools
login-to-adx
Authenticates with Azure Data Explorer using client credentials.
Parameters:
- cluster: The ADX cluster URL (e.g., https://mycluster.eastus.kusto.windows.net)
- database: The database name
- tenantId: The Azure tenant ID
- clientId: The Azure client/application ID
- clientSecret: The Azure client secret
run-adx-query
Runs a KQL query against the connected Azure Data Explorer database.
Parameters:
- query: The KQL query to execute
Development
To run the server in development mode:
npm run dev
License
ISC
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
