Azure MCP Server

🚀 Azure Container Application Remote MCP Server Example

This MCP server uses Server-Sent Events (SSE) for data transmission and authenticates requests using API keys.

🚀 Quick Start

Project Overview

This is a Model Context Protocol (MCP) server based on FastAPI, specifically designed for Azure Container Apps. It provides weather-related tools (such as alerts and forecasts) through a secure, API-key-protected Server-Sent Events (SSE) interface. The server is intended to integrate with MCP-compatible clients, such as Visual Studio Code or custom scripts.

📦 Installation

1. Clone the repository

git clone https://github.com/KRVaghani/Azure-MCP-Server.git
cd Azure-MCP-Server

2. Install prerequisites

• Python 3.11 or higher
• uv

3. Set up the virtual environment and dependencies

uv venv
uv sync

4. Set up the API key

export API_KEYS=devkey  # Or your chosen key

5. Run the server

uv run fastapi dev main.py

💻 Usage Examples

Basic Usage

There is an example Python client (model_request_client.py) for command-line interaction:

python model_request_client.py

• Enter your API key (default is devkey).
• Select a tool: get_alerts (by US state) or get_forecast (by latitude/longitude).
• Enter the required parameters.
• The server response will be displayed in the terminal.

Advanced Usage

You can use curl to test the API:

curl -H "x-api-key: devkey" http://localhost:8000/sse

📚 Documentation

API Endpoints

• /sse (GET): The main SSE endpoint for MCP protocol communication. Requires the x-api-key header.
• /messages (SSE): An internal message stream endpoint (session-based).

Troubleshooting

• If you see ModuleNotFoundError, make sure the virtual environment is activated and the dependencies are installed.
• If the client hangs, check if the server is running and the API keys match.
• For pip issues in the virtual environment, run:

python -m ensurepip --upgrade
python -m pip install --upgrade pip

Contributing

Pull requests are welcome! Please open an issue to discuss major changes first.

License

This project is licensed under the MIT License (add a LICENSE file if needed).

Local Run

Prerequisites:

• Python 3.11 or higher
• uv

Run the server locally:

uv venv
uv sync

# Linux/macOS
export API_KEYS=<AN_API_KEY>
# Windows
set API_KEYS=<AN_API_KEY>

uv run fastapi dev main.py

VS Code MCP configuration (mcp.json):

{
    "inputs": [
        {
            "type": "promptString",
            "id": "weather-api-key",
            "description": "Weather API Key",
            "password": true
        }
    ],
    "servers": {
        "weather-sse": {
            "type": "sse",
            "url": "http://localhost:8000/sse",
            "headers": {
                "x-api-key": "${input:weather-api-key}"
            }
        }
    }
}

Deployment to Azure Container Apps

az containerapp up -g <RESOURCE_GROUP_NAME> -n weather-mcp --environment mcp -l westus --env