weather-mcp
3.1
If you are the rightful owner of weather-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server that provides weather alerts and forecasts for US locations using the National Weather Service API.
Weather MCP Server
A Model Context Protocol (MCP) server that provides weather alerts and forecasts for US locations using the National Weather Service API.
Features
- get-alerts: Get active weather alerts for a US state (by two-letter code, e.g. CA, NY).
- get-forecast: Get a weather forecast for a specific latitude and longitude.
Requirements
- Node.js v16 or higher
- npm (comes with Node.js)
Setup
- Clone or copy this repository to your machine.
- Install dependencies:
npm install - Build the server:
npm run build
Running the Server
To start the server (for local development or direct use):
npm start
Or, to run the built server directly:
node build/index.js
MCP Integration (Claude for Desktop Example)
To use this server with Claude for Desktop or another MCP host, add the following to your claude_desktop_config.json (update the path as needed):
{
"mcpServers": {
"weather": {
"command": "node",
"args": [
"/ABSOLUTE/PATH/TO/weather-mcp/build/index.js"
]
}
}
}
- Replace
/ABSOLUTE/PATH/TO/weather-mcp/build/index.jswith the absolute path to your built server file. - Save and restart your MCP host (e.g., Claude for Desktop).
Usage
Once connected, you can use the following tools:
get-alerts
- Description: Get weather alerts for a US state.
- Input:
state(string, two-letter US state code, e.g. "CA") - Output: List of active alerts or a message if none are found.
get-forecast
- Description: Get weather forecast for a location.
- Input:
latitude(number, e.g. 37.7749)longitude(number, e.g. -122.4194)
- Output: Forecast for the next several periods.
Development
- Edit
src/index.tsto modify or extend the server. - Run
npm run buildafter making changes.
License
MIT
