@dennisk2025/historical-weather-insights
v1.0.0
Published
Provides interesting weather facts and actual historical weather conditions for a given date and location via the Model Context Protocol (MCP).
Readme
Historical Weather Insights MCP Server\n\nHistorical Weather Insights is a Model Context Protocol (MCP) server that provides interesting weather trivia and fetches actual historical weather conditions (such as temperature, precipitation, and windspeed) for any given date and location, using the Open-Meteo Archive API.\n\n## Features\n- get_historical_weather: Fetch historical weather for a latitude, longitude, and date.\n- get_weather_fact: Get a random, interesting weather-related fact.\n\n## Installation\nYou can use this MCP server either by installing via npm or running directly via npx.\n\n### Using npm\n\nnpm install @dennisk2025/historical-weather-insights\n\n### Using npx\n\nnpx @dennisk2025/historical-weather-insights\n\n## Adding to Claude Desktop\n\nclaude --mcp add historical-weather "npx @dennisk2025/historical-weather-insights"\n\n## Usage Examples\n\n### Get Historical Weather\n\nTool: get_historical_weather\n\nParameters:\n- latitude (number): Geographic latitude.\n- longitude (number): Geographic longitude.\n- date (string, YYYY-MM-DD): Date to fetch historical weather for.\n\nExample Call:\n\n{
"tool": "get_historical_weather",
"input": {
"latitude": 40.7128,
"longitude": -74.0060,
"date": "2010-07-15"
}
}\n\nSample Response:\n\n{
"date": "2010-07-15",
"temperature_max": 34.2,
"temperature_min": 25.1,
"precipitation_sum": 0.0,
"windspeed_10m_max": 18.7,
"units": {
"temperature_2m_max": "°C",
"temperature_2m_min": "°C",
"precipitation_sum": "mm",
"windspeed_10m_max": "km/h"
},
"location": {
"latitude": 40.713,
"longitude": -74.006,
"elevation": 10
}
}\n\n### Get Random Weather Fact\n\nTool: get_weather_fact\n\nParameters: none\n\nExample Call:\n\n{
"tool": "get_weather_fact",
"input": {}
}\n\nSample Response:\n\n{
"fact": "The highest temperature ever recorded on Earth was 56.7 °C (134 °F) in Furnace Creek Ranch, Death Valley, California, USA, on July 10, 1913."
}\n\n## Available Tools\n\n### get_historical_weather\n- Description: Fetches historical weather data (temperature, precipitation, etc.) for a given location and date.\n- Parameters:\n - latitude (number): Geographic latitude for the location\n - longitude (number): Geographic longitude for the location\n - date (string): Date in YYYY-MM-DD format\n\n### get_weather_fact\n- Description: Returns a random interesting weather-related fact.\n- Parameters: None\n\n---\n\nBuilt by @dennisk2025. Powered by Open-Meteo.\n
