azure-log-analytics-mcp

# Azure Log Analytics MCP Server An MCP (Model Context Protocol) server for querying Azure Log Analytics using natural language. This server allows large language models to convert natural language queries into KQL (Kusto Query Language) and execute them against Azure Log Analytics. ## Features - Convert natural language queries to KQL using Claude AI - Execute KQL queries against Azure Log Analytics - Format results for easy consumption by LLMs - CLI mode for direct interactions and MCP server mode for LLM integrations ## Prerequisites - Node.js 18.x or higher - An Azure subscription with Log Analytics workspace - An Anthropic API key for Claude AI - Azure CLI configured with appropriate credentials ## Installation ```bash # Clone the repository git clone https://github.com/MananShahTR/azure-log-analytics-mcp.git cd azure-log-analytics-mcp # Install dependencies npm install # Build the project npm run build ``` ## Configuration The server requires the following environment variables: - `ANTHROPIC_API_KEY`: Your Anthropic API key for Claude AI Azure credentials are obtained through Azure CLI credentials. Ensure you're logged in with `az login` before running the server. You'll need to configure the following in the `azure-service.ts` file: - `subscriptionId`: Your Azure subscription ID - `resourceGroup`: The resource group containing your App Insights resource - `appInsightsId`: The name of your Application Insights resource ## Usage ### CLI Tool ```bash # Run as a CLI tool ANTHROPIC_API_KEY=your_key_here node build/index.js ``` ### MCP Server ```bash # Run as an MCP server ANTHROPIC_API_KEY=your_key_here node build/mcp-server.js ``` ### MCP Settings Configuration Add the following to your MCP settings configuration file: ```json { "mcpServers": { "azure-log-analytics": { "command": "node", "args": ["path/to/azure-log-analytics-mcp/build/mcp-server.js"], "env": { "ANTHROPIC_API_KEY": "your_key_here" } } } } ``` ## Tool Usage Once connected, the MCP server provides the following tool: - `query_logs`: Query Azure Log Analytics using natural language - Parameters: - `query`: Natural language query about trace logs (required) - `timeRange`: Optional time range (e.g., "last 24 hours", "past week") - `limit`: Maximum number of results to return ## Examples ```javascript // Example MCP tool use use_mcp_tool({ server_name: "azure-log-analytics", tool_name: "query_logs", arguments: { query: "Show me all errors in the authentication service from the last hour", timeRange: "last hour", limit: 10 } }); ``` ## License MIT