About Weather Alerts & Forecast
Weather Alerts & Forecast is an MCP server for applications that need US National Weather Service alerts and short-term forecasts. It retrieves active alerts by state and forecasts for a latitude and longitude.
Key features
- 01Fetch active NWS alerts by state
- 02Get forecasts for coordinates
- 03Return the next five forecast periods
- 04Use public NWS API data
Use cases
- 01Check active weather alerts in a state
- 02Retrieve a point forecast from coordinates
MCP support
The server exposes `get_alerts` and `get_forecast` tools to MCP clients over stdio. They retrieve NWS alerts by two-letter state code and short-term forecasts by latitude and longitude.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEWeather MCP Server
An MCP server that provides:
- Active US National Weather Service (NWS) alerts by two-letter state code
- Short-term point forecasts (next 5 periods) for latitude/longitude coordinates
Data is sourced from the public NWS API at https://api.weather.gov.
Tools
| Tool | Description | Inputs |
|---|---|---|
get_alerts | Fetch active NWS alerts for a US state | state (string, two-letter code) |
get_forecast | Fetch short-term forecast (next 5 periods) for coordinates | latitude (number), longitude (number) |
Usage (Local)
Install dependencies:
pip install .
Run the MCP server (stdio transport):
python -m weather.weather
Your MCP client should be configured to launch the server via the package entrypoint or the above module path.
Server JSON Summary
See server.json for registry metadata including name, version, tools, and entrypoint configuration.
Publishing Steps (Overview)
- Authenticate with publisher (GitHub namespace):
mcp-publisher login github - Create and push repo to GitHub (see steps below).
- (Optional) Publish to PyPI if distributing as a package.
- Publish to MCP registry:
mcp-publisher publish - Verify:
curl "https://registry.modelcontextprotocol.io/v0/servers?search=io.github.vtiwari/weather-mcp"
Create & Push GitHub Repository
If this directory is not yet a git repo:
git init
git add .
git commit -m "Initial commit: Weather MCP server"
Create repo (GitHub CLI) and push:
gh repo create vtiwari/weather-mcp --public --source . --remote origin --push
If not using GitHub CLI, create the repo manually via the GitHub web UI, then:
git remote add origin https://github.com/vtiwari/weather-mcp.git
git branch -M main
git push -u origin main
Tag version for release consistency:
git tag v0.1.0
git push origin v0.1.0
PyPI Packaging (Optional)
To distribute via PyPI, ensure pyproject.toml includes build backend and metadata (authors, license). Then:
pip install build twine
python -m build
twine upload dist/*
License
MIT (adjust if different).
Disclaimer
This server uses public NOAA/NWS endpoints. Respect API usage guidelines and rate limits.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.