Kusto MCP Backend Service Documentation

This component serves as an intermediary layer (MCP Server) facilitating secure and structured access to Azure Data Explorer (ADX) environments.

Available Functionality

The service exposes the following distinct operational methods:

Metadata Discovery (Table Listing):
- enumerate_local_tables: Fetches a list of all resident/internal tables within the targeted cluster.
- enumerate_remote_tables: Retrieves a manifest of externally linked tables accessible by the cluster.
- enumerate_materialized_views: Lists currently defined materialized view definitions.
Data Query Execution:
- submit_internal_query: Runs Kusto Query Language (KQL) statements against local tables or views.
- submit_external_query: Executes KQL statements specifically targeting external data sources.
Schema Inspection:
- inspect_local_schema: Obtains the structural definition (schema) for an internal table or materialized view.
- inspect_remote_schema: Retrieves the schema definition for an externally sourced table.

Deployment Configuration for Claude Desktop

To integrate this Kusto connector, modify your claude_desktop_config.json file to include the following server definition:

{ "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}}" ] } } }

Local Emulator Usage Note: When connecting to a locally running Azure Data Explorer emulator (e.g., using https://localhost:8082 for the cluster URL), the authentication parameters (--authority_id, --client_id, --client_secret) are unnecessary and should be omitted from the configuration arguments, resulting in: