MCP Server Weather Forecast

🚀 Weather Forecast Tool

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

🚀 Quick Start

Prerequisites

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

Setup

1. Install Dependencies: Install MCP and other required dependencies (see MCP Documentation).
2. Get Coordinates: You need to specify the latitude and longitude of the location.

Usage

1. Import Modules: 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 latitude and longitude of your desired location.

✨ Features

• Weather Forecast: The get_weather function retrieves weather forecast data for 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:
  • The most frequently occurring weather symbols at night, morning, afternoon, and evening.
  • The 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 converts weather symbol codes from the API into human-readable descriptions.

📦 Installation

Dependencies

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

Steps

1. Install MCP and other required dependencies (see MCP Documentation).
2. Specify the latitude and longitude of the location.

💻 Usage Examples

Basic Usage

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")

async def main():
    weather_data = await get_weather(55.6761, 12.5683) # Example: Copenhagen, Denmark
    print(weather_data)

if __name__ == "__main__":
    asyncio.run(main())

📚 Documentation

Tool Definition

• get_weather(latitude: float, longitude: float) -> str
  • Retrieves and formats the weather forecast for a specified location.
  • Parameters:
    • 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

This code uses the FastMCP framework. Refer to the FastMCP documentation for instructions on setting up and running the server.

📄 License

MIT License