Azure Functions Insights MCP Server

An Azure Functions MCP (Model Context Protocol) server that provides comprehensive monitoring and insights tools for your Azure Functions resources. Built with .NET 10 isolated worker and the Azure Functions MCP extension.

Prerequisites

• .NET 10 SDK
• Azure Functions Core Tools
• Azure CLI (for authentication)
• Azure Developer CLI (azd) (for deployment)
• Bicep CLI (for infrastructure)
• An Azure subscription with Azure Functions resources

🚀 Quick Start

Simple 3-Step Setup:

1. Add your Azure Subscription ID to src/local.settings.json:

   {
     "Values": {
       "AZURE_SUBSCRIPTION_ID": "your-subscription-id-here"
     }
   }
   

   Remember to remove .sample from src/local.settings.sample.json

2. Start the MCP server:

   cd src
   func start
   

3. Connect in VS Code:

   • Open .vscode/mcp.json
   • Click "Start" for the local-azure-function-insights server
   • Start using MCP tools in GitHub Copilot Chat!

Example tool invocations in chat:

• #mcp_local-azure-f_ListFunctions List all my Azure Function Apps
• #mcp_local-azure-f_GetFunctionStatus What's the status of my-function-app?
• #mcp_local-azure-f_GetFailedExecutions Show me failed executions for payment-processor
• #mcp_local-azure-f_ListFailingFunctions Which of my functions are failing?
• #mcp_local-azure-f_GetTraceLogs Show me trace logs for broken-app

Features

🔍 Seven Powerful MCP Tools

1. ListFunctions - List all Azure Function Apps in your subscription

   • Filter by resource group
   • Paginated results (default 50 per page)
   • Returns: name, location, state, runtime version, tags

2. GetFunctionStatus - Get detailed status of a specific Function App

   • Current state (Running, Stopped, etc.)
   • List of all functions in the app
   • Runtime version and host information
   • Host health checks (checks /admin/host/status and /admin/host/ping)
   • Detects runtime errors (InternalServerError, host failures)

3. GetFunctionMetrics - Retrieve execution metrics and analytics

   • Total, successful, and failed execution counts
   • Average, min, and max duration statistics
   • Success rate percentage
   • Configurable time range (1-720 hours)

4. GetFailedExecutions - Analyze recent failures with full details

   • Error messages and exception types
   • Complete stack traces for debugging
   • Invocation IDs for correlation
   • Execution duration
   • Includes errors from requests, exceptions, AND trace logs
   • Configurable count (1-100) and time range

5. GetTraceLogs - Get recent trace logs from Application Insights

   • Useful for debugging broken Function Apps
   • Works even when requests/exceptions tables are empty
   • Configurable severity level filtering (Verbose, Info, Warning, Error, Critical)
   • Configurable count and time range

6. ListFailingFunctions - Overview of all failing Function Apps

   • Shows which apps have recent failures
   • Error rates and failure counts for each app
   • Sorted by worst performers first
   • Quick health dashboard for entire subscription

7. QueryApplicationInsights - Execute custom KQL queries

   • Run any Kusto Query Language query
   • Access full Application Insights telemetry
   • Queries Log Analytics workspaces (AppRequests, AppExceptions, AppTraces tables)
   • Custom analytics and reporting
   • Configurable time range

Setup

1. Clone and Restore

git clone https://github.com/liliankasem/azfunc-insights-mcp-server.git
cd /path/to/azfunc-insights-mcp
dotnet restore

... View full README on GitHub