Weather MCP Server

A Model Context Protocol (MCP) server built with fastmcp that exposes exactly 5 weather tools, each calling a different live public weather API. Includes a Groq-powered LLM agent and a browser inbox UI — you ask a weather question in plain English, the LLM picks the right MCP tool, and returns an HTML answer.

Architecture Diagram

flowchart TB
    subgraph Browser["Browser (port 8080)"]
        UI[index.html — LLM Inbox]
    end

    subgraph Agent["LLM Agent (port 8001)"]
        API["/chat · /health"]
        GROQ[Groq LLM]
        MCPClient[MCP Client]
        API --> GROQ
        API --> MCPClient
        GROQ -->|pick tool + format HTML| API
    end

    subgraph MCP["MCP Server (port 8000)"]
        SSE[SSE Endpoint /sse]
        T1[weather_open_meteo]
        T2[weather_wttr]
        T3[weather_7timer]
        T4[weather_openweather]
        T5[weather_weatherapi]
        SSE --> T1 & T2 & T3 & T4 & T5
    end

    subgraph APIs["Live Weather APIs"]
        A1[Open-Meteo\nno key]
        A2[wttr.in\nno key]
        A3[7Timer!\nno key]
        A4[OpenWeatherMap\nfree key]
        A5[WeatherAPI.com\nfree key]
    end

    UI -->|POST /chat| API
    MCPClient -->|SSE| SSE
    T1 --> A1
    T2 --> A2
    T3 --> A3
    T4 --> A4
    T5 --> A5
    T1 & T2 & T3 & T4 & T5 -->|HTML| MCPClient
    API -->|HTML response| UI

Related MCP server: Weather MCP

The 5 Tools & APIs

API Keys

Tools 1–3 work with no keys. For the inbox UI, Groq is required. Weather keys for tools 4–5 are optional — the LLM will pick from whichever tools are available.

1. Copy .env.example to .env

2. Add your GROQ_API_KEY (required for inbox)

3. Optionally add weather API keys for tools 4–5

Quick Start

1. Install dependencies

git clone https://github.com/RimeetMavani/weather-mcp--build.git
cd weather-mcp--build
pip install -r requirements.txt

2. Configure API keys

copy .env.example .env
# Edit .env — add GROQ_API_KEY (free tier, required for LLM inbox)
# Optionally add free weather API keys for tools 4–5

3. Start the MCP server (SSE on port 8000)

python server.py

You should see output like:

Starting MCP server 'Weather MCP Server' with transport 'sse' on http://127.0.0.1:8000/sse

Keep this terminal open.

4. Start the LLM agent (port 8001)

Open a second terminal:

python agent.py

The agent lists MCP tools, lets the Groq LLM pick one for your question, calls the tool, and returns an HTML answer.

5. Serve the HTML inbox UI (port 8080)

Open a third terminal:

python -m http.server 8080

6. Open the browser UI

Go to: http://localhost:8080/index.html

1. Wait for status dots to turn green (agent, MCP, LLM)

2. Type a weather question in the inbox (no tool dropdown — the LLM chooses)

3. View the HTML-formatted LLM response

5 Suggested Inbox Questions

These match the clickable prompts in index.html. The LLM picks the tool — you do not select one manually.

CLI Test (all 5 tools)

With server.py running in another terminal:

python test_client.py

This connects via SSE, lists tools, calls all 5 with live data, prints previews, then closes the connection. This tests the MCP server directly — no Groq agent needed.

Project Files

End Testing

1. Close the browser tab

2. Stop the HTML server: Ctrl+C in the http.server terminal

3. Stop the agent: Ctrl+C in the agent.py terminal

4. Stop the MCP server: Ctrl+C in the server.py terminal