rossshannon weekly weather mcp

WHAT IT CONNECTS

rossshannon weekly weather mcp 为 AI Agent 提供什么

• 🌍 Support for querying weather conditions anywhere in the world
• 🌤️ Hourly forecasts for the next 48 hours
• 📅 Provides detailed 8-day forecasts (today + following 7 days), with morning, afternoon, and evening data points
• 🌧️ Weather summaries and precipitation probabilities
• 🌡️ Detailed weather information including temperature, humidity, wind speed, etc.
• 📍 Support for reporting results in different time zones
• 🗂️ No separate configuration file needed; API key can be passed directly through environment variables or parameters
• Visit [OpenWeatherMap](https://openweathermap.org/) and register an account
• Subscribe to the “One Call API 3.0” plan (offers 1,000 API calls per day for free)
• Wait for API key activation (this can take up to an hour)
• Current weather conditions
• Minute forecast for 1 hour
• Hourly forecast for 48 hours
• Daily forecast for 8 days (including today)
• National weather alerts
• Historical weather data
• **Free tier**: 1,000 API calls per day
• **Default limit**: 2,000 API calls per day (can be adjusted in your account)
• **Billing**: Any calls beyond the free 1,000/day will be charged according to OpenWeatherMap pricing
• **Usage cap**: You can set a call limit in your account to prevent exceeding your budget (including capping your usage at the free tier limit so no costs can be incurred)
• If you reach your limit, you’ll receive a HTTP 429 error response
• `location`: Location name as a string, e.g., “Beijing”, “New York”, “Tokyo”. The tool will handle geocoding this to a latitude/longitude coordinate.
• `api_key`: OpenWeatherMap API key (optional, will read from environment variable if not provided)
• `timezone_offset`: Timezone offset in hours, e.g., 8 for Beijing, -4 for New York. Default is 0 (UTC time). Times in the returned data will be accurate for this timezone.
• Current weather information
• Hourly forecasts for the next 48 hours
• Daily forecasts for 8 days (today + 7 days ahead)
• Morning (9 AM), afternoon (3 PM), and evening (8 PM) data points for each day
• Weather summaries and precipitation probabilities
• Detailed weather information including temperature, humidity, wind speed, etc.
• “🏃‍♂️ Which days this week should I go for a run?”
• “🪴 When’s the best evening to work in my garden this week?”
• “🪁 What’s the windiest day coming up soon for flying a kite?”
• “💧 Will I need to water my garden this week or will rain take care of it?”
• A simplified subset of the data returned by `get_weather`
• Only the current weather information (temperature, feels like, weather condition, humidity, wind, etc.); no forecast data for future time periods
• Useful for quick queries about present conditions only
• Simple location names work: “Paris”, “Tokyo”, “New York”
• For better accuracy, include country codes: “Paris,FR”, “London,GB”, “Portland,US”
• For US cities, you can include state: “Portland,OR,US” or “Portland,ME,US”
• The API supports any location on Earth that OpenWeatherMap can geocode
• Location names are converted to latitude/longitude coordinates internally
• Today (Monday): Light rain (28% chance), 5°C
• Tuesday: Clear, sunny, 10°C
• Wednesday: Light rain (100% chance), 9°C
• Thursday: Moderate rain (100% chance), 10°C
• Friday: Moderate rain (100% chance), 11°C
• Saturday: Partly cloudy, 13°C
• Sunday: Scattered clouds, 17°C
• Make sure you’ve subscribed to the “One Call API 3.0” plan. You’ll need a debit or credit card to enable your account, but you’ll only be charged if you exceed the free tier limit.
• Remember that API key activation can take up to an hour
• Verify you have set the `OPENWEATHER_API_KEY` correctly in environment variables, or check that you’re providing the correct `api_key` parameter when calling the tools
• **“Location not found” error**:
• Check for typos in location names
• Some very small or remote locations might not be in OpenWeatherMap’s database
• **Incorrect location returned**:
• Try using a more accurate city name or add a country code, e.g., “Beijing,CN” or “Porto,PT”
• For US cities with common names, specify the state: “Springfield,IL,US” or “Portland,OR,US”
• For cities with the same name in different countries, always include the country code and state if applicable: “Paris,FR” for Paris, France vs “Paris,TX,US” for Paris, Texas, USA.
• **Rate limiting (429 error)**: You’ve exceeded your API call limit. Check your OpenWeatherMap account settings.
• Set your OpenWeatherMap API key:
• Run the test client:
• Your API key is working properly
• The OpenWeatherMap API is accessible
• The weather data functions are operational
• Test API key handling and validation
• Validate data parsing and formatting
• Verify error handling for API failures
• Test both exposed MCP tools: `get_weather` and `get_current_weather`
• Integration with OpenWeatherMap One Call API 3.0
• Extended forecast data from 2 days to 8 days (today + 7 days)
• Addition of morning, afternoon and evening data points for each day
• Hourly forecasts for the next 48 hours
• Inclusion of weather summaries, wind speed, and precipitation probabilities
• Unit tests, integration tests, and mock client test files