README.md•3.19 kB
# Weather MCP Server
A FastMCP server that provides weather data, forecasts, and alerts for Poke integration.
## 🚀 Features
- **get_current_weather**: Current conditions (from National Weather Service forecast data)
- **get_forecast**: Detailed multi-day forecast (day/night periods)
- **get_weather_alerts**: Real-time alerts and warnings (NWS official alerts)
Data Source: National Weather Service (`https://api.weather.gov`) — no API key required.
## 🛠️ Local Development
```bash
# Install dependencies
pip install -r requirements.txt
# Run the server
python src/server.py
```
## 🔑 API Key Setup
Not required. This server uses the National Weather Service API and does not need an API key.
## 🚢 Deployment
### Deploy to Render
[](https://render.com/deploy)
**Steps:**
1. **Click the "Deploy to Render" button above** or go to [render.com](https://render.com)
2. **Connect your GitHub account to Render** (if you haven't already)
3. **Create a new Web Service:**
- Connect this repository
- **Name**: `weather-mcp`
- **Environment**: `Python 3`
- **Plan**: `Free`
- **Build Command**: `pip install -r requirements.txt`
- **Start Command**: `python src/server.py`
4. No environment variables required
5. **Deploy!**
> Note: On Render's free tier, services go idle after ~15 minutes of inactivity and may require a manual "Deploy" to wake or to pick up the latest commit. Unlike Vercel, pushes do not auto-deploy by default.
Your server will be available at `https://weather-mcp.onrender.com/mcp`
## 🎯 Poke Integration
1. Go to [poke.com/settings/connections](https://poke.com/settings/connections)
2. Add the MCP URL: `https://weather-mcp.onrender.com/mcp`
3. Give it a name like "Weather"
4. Try: "Use the Weather MCP to get the 3-day forecast for Boston."
## References
- Based on the Interaction MCP server template: [MCP Server Template](https://github.com/InteractionCo/mcp-server-template/tree/main)
- Discovered via Interaction’s HackMIT challenge: [Interaction HackMIT Challenge](https://interaction.co/HackMIT)
- National Weather Service API docs: `https://www.weather.gov/documentation/services-web-api`
## 🔧 Available Tools
- `get_current_weather(location, units="metric|imperial")`: Current conditions based on NWS forecast periods
- `get_forecast(location, days=1..5, units="metric|imperial")`: Multi-day forecast (day/night periods)
- `get_weather_alerts(location)`: Official alerts/watches/warnings for the specified location
## 📝 Example Usage
```python
# Get current weather (uses NWS forecast period closest to now)
get_current_weather(location="Seattle", units="metric")
# Get 3-day forecast (day/night periods)
get_forecast(location="New York", days=3, units="imperial")
# Get weather alerts
get_weather_alerts(location="Miami")
```
Notes:
- Locations are resolved via a simple built-in mapping of major US cities. For other places, default coordinates are used. You can extend this with a geocoding service if needed.
- Current conditions are derived from the first forecast period when station observations are unavailable.