Azure Log Navigator MCP

MCP server for Azure Log Analytics — query logs from VS Code Copilot Chat or PyCharm AI Assistant

✨ Features

• 🎯 Local settings for azure logs — in each project you can define your own Azure resources and aliases in LOG_TARGETS.json
• 🔎 Query Azure logs directly from AI chat (Copilot, PyCharm AI Assistant)
• 🎯 Target aliases — friendly names instead of resource IDs
• 🚀 Auto-discovery — scan Azure subscriptions for resources
• 📊 KQL examples — ready-to-use queries for troubleshooting
• 🐳 AKS support — two-step pods/logs workflow
• 🔐 Multiple auth methods — VS Code, Azure CLI, Service Principal

📦 Installation

VS Code

npm install
npm run build
npm run package:vsix

Install azure-log-navigator-*.vsix via Extensions → Install from VSIX.

PyCharm / JetBrains IDE

npm install
npm run build
npm run package:standalone

Extract azlognav-standalone.zip and configure .idea/mcp.json:

{
  "mcpServers": {
    "azlognav": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/tools/azlognav/server.mjs"],
      "env": {
        "LOG_TARGETS_PATH": "C:/tools/azlognav/LOG_TARGETS.json"
      }
    }
  }
}

🛠️ MCP Tools

🚀 Quick Start

1. Sign in to Azure:

   • VS Code: Install Azure Account → Ctrl+Shift+P → "Azure: Sign In"
   • Or: az login in terminal

2. Bootstrap targets:

   • VS Code: Ctrl+Shift+P → "Azure Log Navigator: Bootstrap Log Targets from Azure"

3. Query logs in chat:

   @azlognav show errors from prod AAS in last 30 minutes
   

📚 Documentation

🔐 Authentication

Priority order:

1. VS Code Azure Account (recommended)
2. Environment variables (AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_TENANT_ID)
3. Azure CLI (az login)
4. Managed Identity

⚙️ Configuration

VS Code Settings

🧪 Development

npm install
npm run build
npm run start:mcp    # Run MCP server directly
npm test             # Run unit tests
npm run test:watch   # Run tests in watch mode
npm run test:coverage # Generate coverage report

📝 License

MIT License — see LICENSE