How surmountme/mcp-servers-in-actions works
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: bootstrap.py Application setup · weather.py Open-Meteo forecaster · geocoding.py Open-Meteo geocoder · weather_service.py Weather service
Components 15
MCP entry
- MCP server
weather-mcp-servers/src/mcp_server.py - Application setup
weather-mcp-servers/src/weather_mcp/bootstrap.py - Weather tools
weather-mcp-servers/src/weather_mcp/tools/tools.py
Weather domain
- Weather service
weather-mcp-servers/src/weather_mcp/services/weather_service.py - Geocoding interface
weather-mcp-servers/src/weather_mcp/providers/geocoding.py - Forecast interface
weather-mcp-servers/src/weather_mcp/providers/weather.py - Weather models
weather-mcp-servers/src/weather_mcp/models/models.py - Domain errors
weather-mcp-servers/src/weather_mcp/models/exceptions.py - Weather code mapping
weather-mcp-servers/src/weather_mcp/models/weather_codes.py
Open-Meteo integration
- Settings and URLs
weather-mcp-servers/src/weather_mcp/config.py - HTTP client
weather-mcp-servers/src/weather_mcp/clients/open_meteo/client.py - Open-Meteo geocoder
weather-mcp-servers/src/weather_mcp/clients/open_meteo/geocoding.py - Open-Meteo forecaster
weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py
Other components
- MCP client
- Open-Meteo APIs
Connections 23
- MCP client → MCP server: requests tools
- MCP server → Application setup: sets up
weather-mcp-servers/src/mcp_server.py - Application setup → Settings and URLs: loads
weather-mcp-servers/src/weather_mcp/bootstrap.py - Application setup → HTTP client: creates
weather-mcp-servers/src/weather_mcp/bootstrap.py - Application setup → Open-Meteo geocoder: creates
weather-mcp-servers/src/weather_mcp/bootstrap.py - Application setup → Open-Meteo forecaster: creates
weather-mcp-servers/src/weather_mcp/bootstrap.py - Application setup → Weather service: wires
weather-mcp-servers/src/weather_mcp/bootstrap.py - Application setup → Weather tools: wires
weather-mcp-servers/src/weather_mcp/bootstrap.py - Weather tools → Weather service: delegates to
weather-mcp-servers/src/weather_mcp/tools/tools.py - Weather service → Geocoding interface: searches via
weather-mcp-servers/src/weather_mcp/services/weather_service.py - Weather service → Forecast interface: forecasts via
weather-mcp-servers/src/weather_mcp/services/weather_service.py - Open-Meteo geocoder → HTTP client: queries
weather-mcp-servers/src/weather_mcp/clients/open_meteo/geocoding.py - Open-Meteo forecaster → HTTP client: queries
weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py - Open-Meteo geocoder → Settings and URLs: uses endpoint
weather-mcp-servers/src/weather_mcp/clients/open_meteo/geocoding.py - Open-Meteo forecaster → Settings and URLs: uses endpoint
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
weather-mcp-servers/src/weather_mcp/clients/open_meteo/geocoding.py - Open-Meteo forecaster → Weather models: builds forecasts
weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py - Open-Meteo forecaster → Weather code mapping: describes codes
weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py - Open-Meteo geocoder → Domain errors: raises provider errors
weather-mcp-servers/src/weather_mcp/clients/open_meteo/geocoding.py - Open-Meteo forecaster → Domain errors: raises provider errors
weather-mcp-servers/src/weather_mcp/clients/open_meteo/weather.py - HTTP client → Domain errors: raises provider errors
weather-mcp-servers/src/weather_mcp/clients/open_meteo/client.py - Weather service → Domain errors: raises location errors
weather-mcp-servers/src/weather_mcp/services/weather_service.py