[{"_1":2,"_229":-5,"_230":-5},"loaderData",{"_3":4,"_20":21,"_22":23,"_181":182},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":-5,"_17":18,"_19":-5},"attributes",[15],"BOT","membership","uid","GV820f08BA","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_26":-5,"_27":28,"_29":40,"_99":100,"_180":79},"availableLocales",[],"githubUser","locale",{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","Weather forecast server which returns 7 days of detailed weather anywhere in the world, using the OpenWeatherMap One Call API 3.0.","name","Weekly Weather","readme","# 🌦️ Weekly Weather MCP Server\n\nA weather forecast MCP (Model Context Protocol) server providing **8-day global weather forecasts** and current weather conditions using the [OpenWeatherMap](https://openweathermap.org) [One Call API 3.0](https://openweathermap.org/api/one-call-3).\n\n> This project builds upon an earlier project by [Zippland](https://github.com/Zippland/weather-mcp), with modifications to support full week forecasts and additional time-of-day data points.\n\n

\n $\"Claude$ \n

Animation showing Claude Desktop processing the weather data from the MCP Server

\n
\n

\n $\"Claude$ \n

Claude Desktop showing a detailed weather forecast with lawn mowing recommendations

\n\n## Features\n\n- 🌍 Support for querying weather conditions anywhere in the world\n- 🌤️ Hourly forecasts for the next 48 hours\n- 📅 Provides detailed 8-day forecasts (today + following 7 days), with morning, afternoon, and evening data points\n- 🌧️ Weather summaries and precipitation probabilities\n- 🌡️ Detailed weather information including temperature, humidity, wind speed, etc.\n- 📍 Support for reporting results in different time zones\n- 🗂️ No separate configuration file needed; API key can be passed directly through environment variables or parameters\n\n## Usage\n\n### 1. Get an OpenWeatherMap API Key with One Call API 3.0 Access (free)\n\n1. Visit [OpenWeatherMap](https://openweathermap.org/) and register an account\n2. Subscribe to the “One Call API 3.0” plan (offers 1,000 API calls per day for free)\n3. Wait for API key activation (this can take up to an hour)\n\n#### About the One Call API 3.0\n\nThe One Call API 3.0 provides comprehensive weather data:\n- Current weather conditions\n- Minute forecast for 1 hour\n- Hourly forecast for 48 hours\n- Daily forecast for 8 days (including today)\n- National weather alerts\n- Historical weather data\n\n#### API Usage and Limits\n\n- **Free tier**: 1,000 API calls per day\n- **Default limit**: 2,000 API calls per day (can be adjusted in your account)\n- **Billing**: Any calls beyond the free 1,000/day will be charged according to OpenWeatherMap pricing\n- **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)\n- If you reach your limit, you’ll receive a HTTP 429 error response\n\n> **Note**: API key activation can take several minutes up to an hour. If you receive authentication errors shortly after subscribing or generating a new key, wait a bit and try again later.\n\n### 2. Clone the Repository and Install Dependencies\n\n```bash\n# Clone the repository\ngit clone https://github.com/rossshannon/weekly-weather-mcp.git\ncd weekly-weather-mcp\n\n# Create a virtual environment (recommended)\npython3 -m venv venv\nsource venv/bin/activate # Linux/Mac\n# OR\nvenv\\Scripts\\activate # Windows\n\n# Install dependencies\npip3 install -r requirements.txt\n```\n\nThis will install all the necessary dependencies to run the server and development tools.\n\n### 3. Run the Server\n\nThere are two ways to provide the API key:\n\n#### Method 1: Using Environment Variables\n\n```bash\n# Set environment variables\nexport OPENWEATHER_API_KEY=\"your_api_key\" # Linux/Mac\nset OPENWEATHER_API_KEY=your_api_key # Windows\n\n# Run the server\npython weather_mcp_server.py\n```\n\n#### Method 2: Provide When Calling the Tool\n\nRun directly without setting environment variables:\n\n```bash\npython weather_mcp_server.py\n```\n\nWhen calling the tool, you’ll need to provide the `api_key` parameter.\n\n### 4. Use in MCP Client Configuration\n\nAdd the following configuration to your MCP-supported client (e.g., [Claude Desktop](https://www.anthropic.com/claude-desktop) ([instructions](https://modelcontextprotocol.io/quickstart/user)), [Cursor](https://www.cursor.com/)):\n\n```json\n{\n \"weather_forecast\": {\n \"command\": \"python3\",\n \"args\": [\n \"/full_path/weather_mcp_server.py\"\n ],\n \"env\": {\n \"OPENWEATHER_API_KEY\": \"your_openweathermap_key_here\"\n },\n \"disabled\": false,\n \"autoApprove\": [\"get_weather\", \"get_current_weather\"]\n }\n}\n```\n\nIf you’re using a virtual environment, your configuration should include the full path to the Python executable in the virtual environment:\n\n```json\n{\n \"weather_forecast\": {\n \"command\": \"/full_path/venv/bin/python3\",\n \"args\": [\n \"/full_path/weather_mcp_server.py\"\n ],\n \"env\": {\n \"OPENWEATHER_API_KEY\": \"your_openweathermap_key_here\"\n },\n \"disabled\": false,\n \"autoApprove\": [\"get_weather\", \"get_current_weather\"]\n }\n}\n```\n\n### 5. Available Tools\n\nThe server exposes two tools, `get_weather` and `get_current_weather`. Both tools accept the same parameters:\n\n- `location`: Location name as a string, e.g., “Beijing”, “New York”, “Tokyo”. The tool will handle geocoding this to a latitude/longitude coordinate.\n- `api_key`: OpenWeatherMap API key (optional, will read from environment variable if not provided)\n- `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.\n\n#### get_weather\n\nGet comprehensive weather data for a location including current weather (next 48 hours) and 8-day forecast with detailed information.\n\nReturns:\n- Current weather information\n- Hourly forecasts for the next 48 hours\n- Daily forecasts for 8 days (today + 7 days ahead)\n- Morning (9 AM), afternoon (3 PM), and evening (8 PM) data points for each day\n- Weather summaries and precipitation probabilities\n- Detailed weather information including temperature, humidity, wind speed, etc.\n\nPerfect for use cases like:\n- “🏃‍♂️ Which days this week should I go for a run?”\n- “🪴 When’s the best evening to work in my garden this week?”\n- “🪁 What’s the windiest day coming up soon for flying a kite?”\n- “💧 Will I need to water my garden this week or will rain take care of it?”\n\n#### get_current_weather\n\nGet current weather for a specified location.\n\nReturns:\n- A simplified subset of the data returned by `get_weather`\n- Only the current weather information (temperature, feels like, weather condition, humidity, wind, etc.); no forecast data for future time periods\n- Useful for quick queries about present conditions only\n\n##### Location Lookup Details\n\nThe `location` parameter uses OpenWeatherMap’s geocoding to convert location names to geographic coordinates:\n\n- Simple location names work: “Paris”, “Tokyo”, “New York”\n- For better accuracy, include country codes: “Paris,FR”, “London,GB”, “Portland,US”\n- For US cities, you can include state: “Portland,OR,US” or “Portland,ME,US”\n- The API supports any location on Earth that OpenWeatherMap can geocode\n- Location names are converted to latitude/longitude coordinates internally\n\nIf a location can’t be found, the API will return an error. In case of ambiguous locations, try adding country or state codes for more precise results.\n\n## Usage Examples\n\n### Example 1: Current Weather\n\n```\nUser: What’s the weather like in New York right now?\n\nAI: Let me check the current weather in New York for you.\n[Calling get_current_weather(\"New York\", timezone_offset=-4)]\n\nCurrent weather in New York: 5°C, few clouds, humidity 42%, wind speed 4.1m/s.\n```\n\n### Example 2: Weekly Planning\n\n```\nUser: I need to mow my lawn this week in Boston. Which day would be best?\n\nAI: Let me check the weather forecast for Boston to find the best day for lawn mowing.\n[Calling get_weather(\"Boston\", timezone_offset=-4)]\n\nLooking at the Boston forecast for the week:\n- Today (Monday): Light rain (28% chance), 5°C\n- Tuesday: Clear, sunny, 10°C\n- Wednesday: Light rain (100% chance), 9°C\n- Thursday: Moderate rain (100% chance), 10°C\n- Friday: Moderate rain (100% chance), 11°C\n- Saturday: Partly cloudy, 13°C\n- Sunday: Scattered clouds, 17°C\n\nTuesday would be your best option for mowing the lawn. It will be clear and sunny with no chance of rain, and the temperature will be comfortable at around 10°C.\n```\n\nYou can combine this MCP server with others to achieve multi-step workflows. For example, once the weather has been checked, you can also tell Claude to add that as an event in your calendar to remind yourself of those plans.\n\n

\n $\"Calendar$ \n

Calendar event created by Claude based on the weather forecast

\n\n## Troubleshooting\n\n### API Key Issues\n\nIf you encounter an “Invalid API key” or authorization error:\n1. 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.\n2. Remember that API key activation can take up to an hour\n3. 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\n\n### Other Common Issues\n\n- **“Location not found” error**:\n - Check for typos in location names\n - Some very small or remote locations might not be in OpenWeatherMap’s database\n\n- **Incorrect location returned**:\n - Try using a more accurate city name or add a country code, e.g., “Beijing,CN” or “Porto,PT”\n - For US cities with common names, specify the state: “Springfield,IL,US” or “Portland,OR,US”\n - 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.\n\n- **Rate limiting (429 error)**: You’ve exceeded your API call limit. Check your OpenWeatherMap account settings.\n\n## Development and Testing\n\n### Testing\n\nThis project includes unit tests, integration tests, and mock client test files to validate the MCP server functionality. The server has been manually tested to ensure it works correctly with Claude Desktop, Cursor, and other MCP clients.\n\n#### Manual Client Testing\n\nBefore configuring the server with Claude Desktop or other MCP clients, you can use the included test script to verify your API key and installation:\n\n1. Set your OpenWeatherMap API key:\n ```bash\n export OPENWEATHER_API_KEY=\"your_api_key\"\n ```\n\n2. Run the test client:\n ```bash\n python3 test_mcp_client.py\n ```\n\nThe test script directly calls the weather functions to check the current weather in New York and displays the results. This helps verify that:\n1. Your API key is working properly\n2. The OpenWeatherMap API is accessible\n3. The weather data functions are operational\n\nIf the test shows current weather data, you’re ready to configure the server with Claude Desktop, Cursor, or other MCP clients!\n\n

\n $\"Running$ \n

Running local test client to verify API key and installation

\n\n#### Automated Tests\n\nThe repository includes unit and integration test files that:\n- Test API key handling and validation\n- Validate data parsing and formatting\n- Verify error handling for API failures\n- Test both exposed MCP tools: `get_weather` and `get_current_weather`\n\nThese tests require proper setup of the development environment with all dependencies installed. They’re provided as reference for future development.\n\nTo run the automated tests:\n\n```bash\n# Run unit tests\npython test_weather_mcp.py\n\n# Run integration tests\npython test_mcp_integration.py\n```\n\nThe tests use a sample API response (`test_weather_response.json`) to simulate responses from the OpenWeatherMap API, so they can be run without an API key or internet connection.\n\nThese tests are provided as reference for future development and to ensure the MCP server continues to function correctly after any modifications.\n\n## Credits\n\nThis project is adapted from an original [Weather MCP](https://github.com/Zippland/weather-mcp) by Zippland. The modifications include:\n\n- Integration with OpenWeatherMap One Call API 3.0\n- Extended forecast data from 2 days to 8 days (today + 7 days)\n- Addition of morning, afternoon and evening data points for each day\n- Hourly forecasts for the next 48 hours\n- Inclusion of weather summaries, wind speed, and precipitation probabilities\n- Unit tests, integration tests, and mock client test files\n","English","tag","en-US",{"_41":42,"_43":-5,"_13":44,"_46":32,"_47":32,"_48":49,"_52":53,"_75":-5,"_76":77,"_78":79,"_80":81,"_33":34,"_82":66,"_83":-5,"_84":-5,"_85":-5,"_86":-5,"_87":88,"_92":-5,"_93":62,"_94":-5,"_95":-5,"_17":96,"_97":98},"addedAt",["D",1744324228582],"argumentsJsonSchema",[45],"language:python","descriptionMarkdown","descriptionPlainText","githubProject",{"_35":36,"_50":51},"url","https://github.com/rossshannon/weekly-weather-mcp","githubRepository",{"_54":55,"_56":57,"_58":59,"_60":61,"_33":62,"_63":64,"_68":69,"_70":71,"_73":74},"defaultBranch","master","fullName","rossshannon/weekly-weather-mcp","githubTreeId",109043,"language","Python","weekly-weather-mcp","owner",{"_65":66,"_17":67},"login","rossshannon","1vEGA4djMR","recentStargazers",0,"spdxLicense",{"_33":72},"MIT License","stargazers",2,"glamaJson","id",5297,"inspectable",false,"integrations",[],"namespace","npmPackage","prompts","redditPostForeignId","resources","scores",{"_89":-5,"_90":-5,"_91":-5},"license","quality","security","simpleIcon","slug","supportedPlatforms","tools","rkv0oyc65c","updatedAt",["D",1745147602143],"meta",[101,104,106,113,116,118,121,124,127,130,133,135,138,141,143,145,147,149,151],{"_102":103},"title","Weekly Weather | Glama",{"_105":32,"_33":31},"content",{"_107":108,"_109":110,"_111":112},"href","https://glama.ai/mcp/servers/@rossshannon/weekly-weather-mcp","rel","canonical","tagName","link",{"_105":34,"_114":115},"property","og:title",{"_105":32,"_114":117},"og:description",{"_105":119,"_114":120},"https://glama.ai/logo.png","og:logo",{"_105":122,"_114":123},"https://glama.ai/mcp/servers/@rossshannon/weekly-weather-mcp/og-image","og:image",{"_105":125,"_114":126},"630","og:image:height",{"_105":128,"_114":129},"1200","og:image:width",{"_105":131,"_114":132},"website","og:type",{"_105":108,"_114":134},"og:url",{"_105":136,"_114":137},"ChatGPT alternative for power users","og:site_name",{"_105":139,"_33":140},"summary_large_image","twitter:card",{"_105":136,"_33":142},"twitter:title",{"_105":32,"_33":144},"twitter:description",{"_105":122,"_33":146},"twitter:image",{"_105":125,"_33":148},"twitter:image:height",{"_105":128,"_33":150},"twitter:image:width",{"_152":153},"script:ld+json",{"_154":155,"_156":157},"@context","http://schema.org","@graph",[158],{"_154":159,"_160":161,"_162":163},"https://schema.org","@type","BreadcrumbList","itemListElement",[164,171,174,178],{"_160":165,"_166":167,"_33":168,"_169":170},"ListItem","item","https://glama.ai/","Glama","position",1,{"_160":165,"_166":172,"_33":173,"_169":74},"https://glama.ai/mcp","MCP",{"_160":165,"_166":175,"_33":176,"_169":177},"https://glama.ai/mcp/servers","Servers",3,{"_160":165,"_166":108,"_33":34,"_169":179},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_26":-5,"_29":183,"_99":193,"_228":-5},{"_41":184,"_43":-5,"_13":185,"_46":32,"_47":32,"_48":186,"_52":187,"_75":-5,"_76":77,"_78":79,"_80":190,"_33":34,"_82":66,"_83":-5,"_84":-5,"_85":-5,"_86":-5,"_87":191,"_92":-5,"_93":62,"_94":-5,"_95":-5,"_17":96,"_97":192},["D",1744324228582],[45],{"_35":36,"_50":51},{"_54":55,"_56":57,"_58":59,"_60":61,"_33":62,"_63":188,"_68":69,"_70":189,"_73":74},{"_65":66,"_17":67},{"_33":72},[],{"_89":-5,"_90":-5,"_91":-5},["D",1745147602143],[194,196,198,200,202,203,204,205,206,207,208,209,210,211,212,213,214,215,216],{"_102":195},"Reviews | Weekly Weather | Glama",{"_105":197,"_33":31},"Read community reviews and feedback for Weekly Weather. Discover user experiences, ratings, strengths, and potential limitations of this MCP implementation from actual users.",{"_107":199,"_109":110,"_111":112},"https://glama.ai/mcp/servers/@rossshannon/weekly-weather-mcp/reviews",{"_105":201,"_114":115},"Reviews | Weekly Weather",{"_105":197,"_114":117},{"_105":119,"_114":120},{"_105":122,"_114":123},{"_105":125,"_114":126},{"_105":128,"_114":129},{"_105":131,"_114":132},{"_105":199,"_114":134},{"_105":136,"_114":137},{"_105":139,"_33":140},{"_105":136,"_33":142},{"_105":197,"_33":144},{"_105":122,"_33":146},{"_105":125,"_33":148},{"_105":128,"_33":150},{"_152":217},{"_154":155,"_156":218},[219],{"_154":159,"_160":161,"_162":220},[221,222,223,224,225],{"_160":165,"_166":167,"_33":168,"_169":170},{"_160":165,"_166":172,"_33":173,"_169":74},{"_160":165,"_166":175,"_33":176,"_169":177},{"_160":165,"_166":108,"_33":34,"_169":179},{"_160":165,"_166":199,"_33":226,"_169":227},"Reviews",5,"review","actionData","errors"]

Rate & Review