# surmountme/mcp-servers-in-actions architecture

> Architecture diagram of the GitHub repository surmountme/mcp-servers-in-actions, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/surmountme/mcp-servers-in-actions
- Repository: https://github.com/surmountme/mcp-servers-in-actions

## Overview

This is a weather MCP server: clients request location search or forecasts through the MCP entry point, which exposes weather tools and delegates to a service. The service resolves locations and requests forecasts through provider interfaces; Open-Meteo adapters perform the external lookups and return structured results. The graph includes the sampled runtime layers and weather-code mapping. The top-level server excerpt was not provided, so its connection to application setup is shown as unverified; detailed MCP transport behavior is omitted.

Main entry points: [`weather-mcp-servers/src/weather_mcp/bootstrap.py`](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/bootstrap.py) (Application setup), [`weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py`](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py) (Open-Meteo forecaster), [`weather-mcp-servers/src/weather_mcp/clients/open_meteo/geocoding.py`](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/clients/open_meteo/geocoding.py) (Open-Meteo geocoder), [`weather-mcp-servers/src/weather_mcp/services/weather_service.py`](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/services/weather_service.py) (Weather service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["MCP entry"]
  node_server["MCP server<br/>[mcp_server.py]"]
  node_bootstrap["Application setup<br/>[bootstrap.py]"]
  node_tools["Weather tools<br/>[tools.py]"]
end

subgraph group_domain["Weather domain"]
  node_service["Weather service<br/>[weather_service.py]"]
  node_geocoding_api["Geocoding interface<br/>[geocoding.py]"]
  node_weather_api["Forecast interface<br/>[weather.py]"]
  node_models["Weather models<br/>[models.py]"]
  node_errors["Domain errors<br/>[exceptions.py]"]
  node_codes["Weather code mapping<br/>[weather_codes.py]"]
end

subgraph group_integration["Open-Meteo integration"]
  node_settings["Settings and URLs<br/>[config.py]"]
  node_http["HTTP client<br/>[client.py]"]
  node_geocoder["Open-Meteo geocoder<br/>[geocoding.py]"]
  node_forecaster["Open-Meteo forecaster<br/>[weather.py]"]
end

node_user(("MCP client"))
node_openmeteo(("Open-Meteo APIs"))

node_user -.->|"requests tools"| node_server
node_server -.->|"sets up"| node_bootstrap
node_bootstrap -->|"loads"| node_settings
node_bootstrap -->|"creates"| node_http
node_bootstrap -->|"creates"| node_geocoder
node_bootstrap -->|"creates"| node_forecaster
node_bootstrap -->|"wires"| node_service
node_bootstrap -->|"wires"| node_tools
node_tools -->|"delegates to"| node_service
node_service -->|"searches via"| node_geocoding_api
node_service -->|"forecasts via"| node_weather_api
node_geocoder -->|"queries"| node_http
node_forecaster -->|"queries"| node_http
node_geocoder -->|"uses endpoint"| node_settings
node_forecaster -->|"uses endpoint"| node_settings
node_http -->|"sends requests"| node_openmeteo
node_geocoder -->|"builds locations"| node_models
node_forecaster -->|"builds forecasts"| node_models
node_forecaster -->|"describes codes"| node_codes
node_geocoder -->|"raises provider errors"| node_errors
node_forecaster -->|"raises provider errors"| node_errors
node_http -->|"raises provider errors"| node_errors
node_service -->|"raises location errors"| node_errors

click node_server "https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/mcp_server.py"
click node_bootstrap "https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/bootstrap.py"
click node_tools "https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/tools/tools.py"
click node_service "https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/services/weather_service.py"
click node_geocoding_api "https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/providers/geocoding.py"
click node_weather_api "https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/providers/weather.py"
click node_models "https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/models/models.py"
click node_errors "https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/models/exceptions.py"
click node_codes "https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/models/weather_codes.py"
click node_settings "https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/config.py"
click node_http "https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/clients/open_meteo/client.py"
click node_geocoder "https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/clients/open_meteo/geocoding.py"
click node_forecaster "https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_bootstrap,node_tools,node_user toneBlue
class node_service,node_geocoding_api,node_weather_api,node_models,node_errors,node_codes toneAmber
class node_settings,node_http,node_geocoder,node_forecaster,node_openmeteo toneMint
```

## Components

### MCP entry

- [MCP server](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/mcp_server.py): `weather-mcp-servers/src/mcp_server.py`
- [Application setup](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/bootstrap.py): `weather-mcp-servers/src/weather_mcp/bootstrap.py`
- [Weather tools](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/tools/tools.py): `weather-mcp-servers/src/weather_mcp/tools/tools.py`

### Weather domain

- [Weather service](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/services/weather_service.py): `weather-mcp-servers/src/weather_mcp/services/weather_service.py`
- [Geocoding interface](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/providers/geocoding.py): `weather-mcp-servers/src/weather_mcp/providers/geocoding.py`
- [Forecast interface](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/providers/weather.py): `weather-mcp-servers/src/weather_mcp/providers/weather.py`
- [Weather models](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/models/models.py): `weather-mcp-servers/src/weather_mcp/models/models.py`
- [Domain errors](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/models/exceptions.py): `weather-mcp-servers/src/weather_mcp/models/exceptions.py`
- [Weather code mapping](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/models/weather_codes.py): `weather-mcp-servers/src/weather_mcp/models/weather_codes.py`

### Open-Meteo integration

- [Settings and URLs](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/config.py): `weather-mcp-servers/src/weather_mcp/config.py`
- [HTTP client](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/clients/open_meteo/client.py): `weather-mcp-servers/src/weather_mcp/clients/open_meteo/client.py`
- [Open-Meteo geocoder](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/clients/open_meteo/geocoding.py): `weather-mcp-servers/src/weather_mcp/clients/open_meteo/geocoding.py`
- [Open-Meteo forecaster](https://github.com/surmountme/mcp-servers-in-actions/blob/main/weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py): `weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py`

### Other components

- **MCP client**
- **Open-Meteo APIs**

## Connections

- MCP client → MCP server: requests tools
- MCP server → Application setup: sets up (evidence: `weather-mcp-servers/src/mcp_server.py`)
- Application setup → Settings and URLs: loads (evidence: `weather-mcp-servers/src/weather_mcp/bootstrap.py`)
- Application setup → HTTP client: creates (evidence: `weather-mcp-servers/src/weather_mcp/bootstrap.py`)
- Application setup → Open-Meteo geocoder: creates (evidence: `weather-mcp-servers/src/weather_mcp/bootstrap.py`)
- Application setup → Open-Meteo forecaster: creates (evidence: `weather-mcp-servers/src/weather_mcp/bootstrap.py`)
- Application setup → Weather service: wires (evidence: `weather-mcp-servers/src/weather_mcp/bootstrap.py`)
- Application setup → Weather tools: wires (evidence: `weather-mcp-servers/src/weather_mcp/bootstrap.py`)
- Weather tools → Weather service: delegates to (evidence: `weather-mcp-servers/src/weather_mcp/tools/tools.py`)
- Weather service → Geocoding interface: searches via (evidence: `weather-mcp-servers/src/weather_mcp/services/weather_service.py`)
- Weather service → Forecast interface: forecasts via (evidence: `weather-mcp-servers/src/weather_mcp/services/weather_service.py`)
- Open-Meteo geocoder → HTTP client: queries (evidence: `weather-mcp-servers/src/weather_mcp/clients/open_meteo/geocoding.py`)
- Open-Meteo forecaster → HTTP client: queries (evidence: `weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py`)
- Open-Meteo geocoder → Settings and URLs: uses endpoint (evidence: `weather-mcp-servers/src/weather_mcp/clients/open_meteo/geocoding.py`)
- Open-Meteo forecaster → Settings and URLs: uses endpoint (evidence: `weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py`)
- HTTP client → Open-Meteo APIs: sends requests
- Open-Meteo geocoder → Weather models: builds locations (evidence: `weather-mcp-servers/src/weather_mcp/clients/open_meteo/geocoding.py`)
- Open-Meteo forecaster → Weather models: builds forecasts (evidence: `weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py`)
- Open-Meteo forecaster → Weather code mapping: describes codes (evidence: `weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py`)
- Open-Meteo geocoder → Domain errors: raises provider errors (evidence: `weather-mcp-servers/src/weather_mcp/clients/open_meteo/geocoding.py`)
- Open-Meteo forecaster → Domain errors: raises provider errors (evidence: `weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py`)
- HTTP client → Domain errors: raises provider errors (evidence: `weather-mcp-servers/src/weather_mcp/clients/open_meteo/client.py`)
- Weather service → Domain errors: raises location errors (evidence: `weather-mcp-servers/src/weather_mcp/services/weather_service.py`)
