Azure Data Explorer MCP Server
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 ##…
Explore
- Login to Azure Data Explorer using service principal (client credentials)
- Run KQL queries against an Azure Data Explorer database
- View formatted query results
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
- Node.js (v16 or higher)
- npm (v7 or higher)
- Azure Data Explorer cluster
- Service Principal with access to Azure Data Explorer
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.
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
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"
]
}
}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.
