Pulls real-time weather data from the National Weather Service API with two focused tools: get_alerts fetches active alerts by state code, and get_forecast grabs the next five forecast periods for any lat/long point in the US. Reach for this when you need Claude to check current weather warnings or pull a quick forecast without leaving the conversation. It's a thin wrapper over api.weather.gov, so you get official NWS data with minimal overhead. Install via pip, run the stdio transport, and point your MCP client at the Python module. No API keys needed since it uses public NOAA endpoints.
An MCP server that provides:
Data is sourced from the public NWS API at https://api.weather.gov.
| 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) |
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.
See server.json for registry metadata including name, version, tools, and entrypoint configuration.
mcp-publisher login github
mcp-publisher publish
curl "https://registry.modelcontextprotocol.io/v0/servers?search=io.github.vtiwari/weather-mcp"
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
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/*
MIT (adjust if different).
This server uses public NOAA/NWS endpoints. Respect API usage guidelines and rate limits.