Provides weather information tools using the National Weather Service (NWS) API, enabling retrieval of weather alerts for US states and forecasts for specific locations by latitude/longitude coordinates.
Weather MCP Server
This is a Model Context Protocol (MCP) server that provides weather information using the National Weather Service (NWS) API.
Features
- Get weather alerts for a US state
- Get weather forecast for a specific location (using latitude and longitude)
Requirements
- Python 3.10+
- FastMCP
- httpx
Installation
- Clone this repository
- Set up a virtual environment:
- Install the required packages using uv:
Configuration
The server uses a configuration file config.py
with the following settings:
NWS_API_BASE
: The base URL for the National Weather Service APIUSER_AGENT
: The User-Agent string used when making requests to the NWS APILOG_LEVEL
: The logging level (e.g., "INFO", "DEBUG")LOG_FORMAT
: The format string for log messagesREQUEST_TIMEOUT
: The timeout for API requests in seconds
You can modify these settings in the config.py
file to customize the server behavior.
Usage
Running the server standalone
To run the server standalone:
- Activate the virtual environment if not already activated:
- Run the server:
Using with Cline
The Weather MCP Server has been added to the Cline configuration. To use it within Cline:
- Ensure that Cline is properly set up and running.
- The Weather MCP Server will be available as a tool named "weather".
- You can use the following tools within Cline:a.
get_alerts(state: str)
: Get weather alerts for a US state (use two-letter state code, e.g., "CA" for California) b.get_forecast(latitude: float, longitude: float)
: Get weather forecast for a specific location
Example usage in Cline:
Note: The exact syntax for calling MCP tools may vary depending on your Cline setup. Refer to Cline documentation for the most up-to-date usage instructions.
Error Handling and Logging
The server includes improved error handling for API requests and logging. If an error occurs during a request, the server will log the error and return an appropriate error message. Logs are printed to the console with the configured log level and format.
Testing
Unit Tests
To run the unit tests:
These tests cover the basic functionality of the get_alerts
and get_forecast
tools.
Manual Testing
To manually test the server, you can use the MCP client to call the provided tools. Here are some example commands:
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is open source and available under the MIT License.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
This is a Model Context Protocol (MCP) server that provides weather information using the National Weather Service (NWS) API.
Features Get weather alerts for a US state Get weather forecast for a specific location (using latitude and longitude)
- Features
- Requirements
- Installation
- Configuration
- Usage
- Error Handling and Logging
- Testing
- Contributing
- License
Related Resources
Related MCP Servers
- -securityFlicense-qualityThis SSE-based MCP server allows users to connect and interact with National Weather Service APIs to retrieve weather alerts and forecasts.Last updated -90Python
- AsecurityAlicenseAqualityModel Context Protocol (MCP) server that provides weather forecast, warnings, water level associated with flood, and earthquake reports from Malaysia Government's Open API.Last updated -4PythonMIT License
- -securityFlicense-qualityAn MCP server implementation that allows users to fetch and display weather information for specified cities, including temperature, humidity, wind speed, and weather descriptions.Last updated -Python
- -securityAlicense-qualityAn MCP server that connects to OpenWeatherMap's API to provide current weather data and multi-day forecasts for locations worldwide in different measurement units.Last updated -12TypeScriptMIT License