README.md•1.96 kB
# 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
1. Install the required dependencies:
```
pip install -r requirements.txt
```
2. Place your Azure usage CSV file in the `data` directory (the default file is `BCAzureUsage 1.csv`).
3. 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:
```json
{
"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:**
```json
{
"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:**
```json
{
"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?"