mcp-server-weather-forecast

Description

This Python code provides a tool to fetch and summarize weather forecasts for a given location using the MET Norway API. It leverages the FastMCP framework for tool registration and uses httpx for asynchronous HTTP requests.

Features

• Weather Forecast: The get_weather function retrieves weather forecast data for a specified latitude and longitude.

• Daily Summary: The summarize_daily_timeseries_most_occurrences function processes the raw forecast data to provide a concise daily summary, including:

  • Most frequent weather symbols for night, morning, afternoon, and evening.
  • Minimum and maximum temperatures for the day.
  • The forecast will be returned in local time.

• HTTP Requests: The make_net_request function handles asynchronous HTTP requests to the MET Norway API.

• Weather Symbol Mapping: The map_weather_symbol function translates weather symbol codes from the API into human-readable descriptions.

Dependencies

• Python 3.13+
• collections
• datetime
• typing
• asyncio
• json
• httpx
• mcp.server.fastmcp

Setup

1. Install Dependencies:

   Install MCP and other dependencies as needed (see MCP documentation)

2. Obtain Coordinates: You'll need the latitude and longitude for the location you want the weather forecast for.

Usage

1. Import: Import the necessary modules and initialize the FastMCP server.

   from collections import Counter
   from datetime import datetime, timezone, timedelta
   from mcp.server.fastmcp import FastMCP
   from typing import Any
   import asyncio
   import json
   import httpx
   
   mcp = FastMCP("weather")
   

2. Use the get_weather tool:

   async def main():
       weather_data = await get_weather(55.6761, 12.5683) # Example: Copenhagen, Denmark
       print(weather_data)
   
   if __name__ == "__main__":
       asyncio.run(main())
   

   Replace 55.6761 and 12.5683 with the desired latitude and longitude.

Tool Definition

* get_weather(latitude: float, longitude: float) -> str * Retrieves and formats the weather forecast for a given location. * Arguments: * latitude (float): The latitude of the location. * longitude (float): The longitude of the location. * Returns: * str: A formatted string containing the daily weather forecast.

MCP

The code uses the FastMCP framework. Please refer to the FastMCP documentation for details on how to set up and run the server.

License

MIT License