MCP Server Kusto

🚀 Kusto MCP Server

A MCP server that provides access to Azure Data Explorer (ADX) clusters.

🚀 Quick Start

This server offers a range of tools for interacting with ADX clusters and specific configuration steps for Claude Desktop.

✨ Features

The server provides the following tools:

List Tables

• list_internal_tables: Lists all internal tables in the cluster.
• list_external_tables: Lists all external tables in the cluster.
• list_materialized_views: Lists all materialized views in the cluster.

Execute Queries

• execute_query_internal_table: Executes a query on an internal table or materialized view.
• execute_query_external_table: Executes a query on an external table.

Get Table Schemas

• get_internal_table_schema: Retrieves the schema information of an internal table or materialized view.
• get_external_table_schema: Retrieves the schema information of an external table.

📦 Installation

Claude Desktop Configuration

Edit the claude_desktop_config.json file to add the following configuration:

{
  "mcpServers": {
    "kusto": {
      "command": "uv",
      "args": [
        "--directory",
        "{{PATH_TO_PROJECT}}\\mcp-server-kusto\\src\\mcp_server_kusto",
        "run",
        "mcp-server-kusto",
        "--cluster",
        "{{ADX_CLUSTER_URL}}",
        "--authority_id",
        "{{TENANT_ID}}",
        "--client_id",
        "{{CLIENT_ID}}",
        "--client_secret",
        "{{CLIENT_SECRET}}"
      ]
    }
  }
}

When using the Azure Data Explorer emulator for local development, you can provide the cluster URL like https://localhost:8082 and do not need to provide --authority_id, --client_id, and --client_secret.

{
  "mcpServers": {
    "kusto": {
      "command": "uv",
      "args": [
        "--directory",
        "{{PATH_TO_PROJECT}}\\mcp-server-kusto\\src\\mcp_server_kusto",
        "run",
        "mcp-server-kusto",
        "--cluster",
        "{{ADX_CLUSTER_URL}}"
      ]
    }
  }
}

💡 Usage Tip

When using the Azure Data Explorer emulator for local development, simplify the configuration by omitting the --authority_id, --client_id, and --client_secret parameters.