Enables GitHub Copilot to access real-time weather data through the National Weather Service API, providing weather forecasts and active weather alerts for US locations.
Serves as the runtime environment for the MCP server, allowing it to process requests for weather information through the National Weather Service API.
Weather MCP Server
A Model Context Protocol (MCP) server that provides weather information and alerts using the National Weather Service (NWS) API. This server enables AI assistants to access real-time weather data for US locations.
Features
Weather Forecasts: Get detailed weather forecasts for any US location using latitude/longitude coordinates
Weather Alerts: Retrieve active weather alerts for any US state
NWS Integration: Uses the official National Weather Service API for reliable, up-to-date weather data
MCP Compatible: Works with any MCP-compatible AI assistant or application
Available Tools
get_forecast
Get weather forecast for a specific location.
Parameters:
latitude
(number): Latitude of the location (-90 to 90)longitude
(number): Longitude of the location (-180 to 180)
Returns: Detailed weather forecast including temperature, wind conditions, and weather descriptions for multiple periods.
get_alerts
Get active weather alerts for a US state.
Parameters:
state
(string): Two-letter state code (e.g., "CA", "NY", "TX")
Returns: List of active weather alerts including severity, affected areas, and descriptions.
Prerequisites
Node.js (version 14 or higher)
npm or yarn
An MCP-compatible client (like VS Code with GitHub Copilot)
Installation
Clone the repository:
git clone <repository-url> cd weather-mcp-serverInstall dependencies:
npm install
Building the Server
Build the TypeScript code to JavaScript:
This will:
Compile TypeScript files from
src/
tobuild/
Make the main executable file executable (
chmod 755 build/index.js
)
Usage with VS Code GitHub Copilot
To use this weather MCP server with VS Code GitHub Copilot, you need to update your MCP configuration:
Step 1: Update MCP Configuration
Edit your mcp.json
file (usually located in your VS Code settings directory) and add the weather server:
Note: Replace the path in args
with the absolute path to your built index.js
file.
Step 2: Restart VS Code
After updating the configuration, restart VS Code to load the new MCP server.
Step 3: Use Weather Tools
Once configured, you can ask GitHub Copilot for weather information:
"What's the weather forecast for San Francisco?" (Copilot will ask for coordinates or you can provide: latitude 37.7749, longitude -122.4194)
"Are there any weather alerts in California?" (Use state code "CA")
"Get me the forecast for latitude 40.7128, longitude -74.0060" (New York City)
Example Usage
Getting Weather Forecast
Getting Weather Alerts
Development
Project Structure
Running in Development
Debugging
The server logs errors to stderr, which you can monitor when running the server directly or check in your MCP client's logs.
API Limitations
US Only: The National Weather Service API only provides data for US locations
Rate Limiting: The NWS API has rate limits; avoid making excessive requests
Data Availability: Some remote or maritime locations may not have forecast data available
Contributing
Fork the repository
Create a feature branch
Make your changes
Build and test the server
Submit a pull request
License
ISC License - see package.json for details.
Troubleshooting
Server Not Loading
Ensure the path in
mcp.json
points to the correctbuild/index.js
fileVerify the server was built successfully with
npm run build
Check VS Code's MCP logs for error messages
No Weather Data
Verify you're using valid US coordinates
Check that the NWS API is accessible from your network
Ensure you're using valid two-letter state codes for alerts
Permission Errors
Make sure the
build/index.js
file is executableThe build script should handle this automatically with
chmod 755
Enables AI assistants to access real-time US weather forecasts and alerts through the National Weather Service API.
Related MCP Servers
- -securityFlicense-qualityA lightweight microservice that fetches weather alerts and forecasts from the National Weather Service API, providing U.S. state-level alerts and location-based forecasts.Last updated -
- -securityFlicense-qualityProvides weather forecast and alert data for US locations through the National Weather Service API, enabling access to real-time weather alerts by state and detailed forecasts by coordinates.Last updated -
- AsecurityFlicenseAqualityProvides tools to fetch real-time weather data from the National Weather Service API, allowing users to retrieve weather alerts by state and detailed forecasts by coordinates.Last updated -260
- -securityFlicense-qualityA containerized server that provides weather tools for AI assistants, allowing them to access US weather alerts and forecasts through the National Weather Service API.Last updated -60