# Azure Maps MCP Server Setup

This MCP server provides access to Azure Maps static imagery.

## Prerequisites

- Python 3.10 or higher
- An Azure Maps Subscription Key

## 1. Get an Azure Maps Subscription Key

1. Go to the [Azure Portal](https://portal.azure.com/).
2. Create an **Azure Maps Account** resource.
3. Once created, go to **Authentication** in the left menu.
4. Copy the **Primary Key** (or Secondary Key). This is your Subscription Key.

## 2. Installation

1. Clone or navigate to this repository.
2. Install the required Python packages:

```bash
pip install -r requirements.txt
# OR if using the provided pyproject.toml
pip install .
```

(Note: You may need to create a virtual environment first: `python -m venv venv && source venv/bin/activate`)

## 3. Configuration

Set your API key as an environment variable:

```bash
export AZURE_MAPS_SUBSCRIPTION_KEY="your_subscription_key_here"
```

## 4. Running the Server

You can run the server directly (stdio mode):

```bash
python azure_maps_mcp.py
```

## 5. Using with MCP Clients

### Claude Desktop

Add the following to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "azure-maps": {
      "command": "python",
      "args": ["/absolute/path/to/azure_maps_mcp.py"],
      "env": {
        "AZURE_MAPS_SUBSCRIPTION_KEY": "your_subscription_key_here"
      }
    }
  }
}
```

### Inspecting with MCP Inspector

To test the server interactively:

```bash
npx @modelcontextprotocol/inspector python azure_maps_mcp.py
```

(Ensure you have `AZURE_MAPS_SUBSCRIPTION_KEY` set in your terminal session before running the inspector).