bingMapsMCP/setup.md

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.
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:

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:

export AZURE_MAPS_SUBSCRIPTION_KEY="your_subscription_key_here"

4. Running the Server

You can run the server directly (stdio mode):

python azure_maps_mcp.py

5. Using with MCP Clients

Claude Desktop

Add the following to your claude_desktop_config.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:

npx @modelcontextprotocol/inspector python azure_maps_mcp.py

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