trackmcp
Back to directory
shiragannavar

mcp-server---weather

View on GitHub

An MCP server for Claude that provides real-time weather alerts and forecasts using the U.S. National Weather Service API. Built with fastmcp and httpx, it exposes two tools: get_alerts (by state) and get_forecast (by lat/lon). Uses stdio transport for Claude integration.

2 stars PythonDeveloper Kits Updated Aug 4, 2025

Documentation

MCP Weather Server for Claude

This project implements an MCP server using the `fastmcp` interface, designed to serve as a Claude tool. It connects to the U.S. National Weather Service (NWS) API to provide real-time weather alerts and forecasts.

✨ Features

  • 🔔 Get Active Alerts: Retrieve current weather alerts by U.S. state.
  • 🌤️ Get Forecast: Fetch detailed forecasts by latitude and longitude.
  • Asynchronous & Fast: Built with `httpx` and `fastmcp` for high-performance async operations.

🧠 Powered by Claude

This server is built to serve as a Claude-compatible external tool via the MCP protocol, using `stdio` transport.

🛠️ Code Overview

Main Components

  • `FastMCP`: Initializes the MCP server.
  • `make_nws_request()`: A helper for calling the NWS API with retries and headers.
  • `get_alerts(state: str)`: Claude-accessible tool to get weather alerts for a given U.S. state.
  • `get_forecast(latitude: float, longitude: float)`: Claude-accessible tool to get the forecast for any lat/lon pair.

Example Tool Usage

python
await get_alerts("CA")
await get_forecast(37.7749, -122.4194)

🌐 External API

National Weather Service API: https://weather.gov/documentation/services-web-api

📄 License

MIT License. Feel free to fork, modify, and use this server as a base for your own Claude tools.

Frequently asked questions

What is mcp-server---weather?

mcp-server---weather is An MCP server for Claude that provides real-time weather alerts and forecasts using the U.S. National Weather Service API. Built with fastmcp and httpx, it exposes two tools: get_alerts (by state) and get_forecast (by lat/lon). Uses stdio transport for Claude integration.

How do I install mcp-server---weather?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mcp-server---weather open source?

Yes — it is hosted on GitHub at https://github.com/shiragannavar/MCP-Server---Weather and has 2 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP