What is Mcp Server Weather Forecast

mcp-server-weather-forecast is a Python-based tool that utilizes the MET Norway API to fetch and summarize weather forecasts for specified locations. It operates on the FastMCP framework, enabling efficient tool registration and asynchronous HTTP requests.

Use cases

Use cases include providing weather updates for travel apps, generating daily weather reports for businesses, integrating weather forecasts into smart home systems, and assisting in outdoor event planning.

How to use

To use mcp-server-weather-forecast, first install the necessary dependencies and obtain the latitude and longitude for your desired location. Import the required modules, initialize the FastMCP server, and call the get_weather function with the coordinates to retrieve the weather data.

Key features

Key features include: 1) Weather Forecast retrieval for specific coordinates, 2) Daily summaries that highlight the most frequent weather symbols and temperature ranges, 3) Asynchronous HTTP request handling to the MET Norway API, and 4) Human-readable weather symbol mapping.

Where to use

mcp-server-weather-forecast can be used in various fields such as meteorology, travel planning, event organization, and any application requiring weather data for decision-making.

Weather Forecast Tool

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