Azure Usage MCP Server

This is a Model Context Protocol (MCP) server for analyzing Azure usage data from CSV files. It provides insights, summaries, and visualizations of Azure cost and usage patterns.

Features

Analyze Azure usage data from CSV files
Generate cost summaries and visualizations
Identify top services and regions by cost
Respond to natural language queries about Azure usage
Fully compatible with the Model Context Protocol (MCP)

Setup

Install the required dependencies:
pip install -r requirements.txt
Place your Azure usage CSV file in the data directory (the default file is BCAzureUsage 1.csv).
Run the server:
python claude_mcp.py

Configuration for Claude or other AI assistants

You can configure this MCP server in your AI assistant configuration using the following format:

{
  "mcpServers": {
    "azure-usage-analyzer": {
      "command": "python",
      "args": ["claude_mcp.py"],
      "cwd": "path/to/mcp-server",
      "env": {}
    }
  }
}

MCP Protocol Support

This server implements the Model Context Protocol (MCP) version 2024-11-05. It supports the following MCP methods:

initialize: Establishes a connection with the MCP client
search: Processes natural language queries about Azure usage data

API Endpoints

GET /

Returns basic server information and available endpoints.

POST /context

Processes Azure usage data and provides insights based on a specific query.

Request format:

{
  "query": "Show me Azure usage by region",
  "params": {
    "dataset": "BCAzureUsage 1.csv"
  }
}

POST /search

General-purpose search endpoint for querying Azure usage data.

Request format:

{
  "query": "What are my top costs by region?"
}

Example Queries

"Show me Azure usage by region"
"What are my top costs?"
"Analyze service type usage"
"Which services cost the most?"