Weather MCP Server

A simple Model Context Protocol (MCP) server that exposes weather tools backed by the US National Weather Service (NWS) API.

The server runs over stdio and can be plugged into any MCP-compatible client (e.g. Cursor, Claude Desktop).

Tools

The server registers two tools:

get_alerts — Get active weather alerts for a US state.
- Input: state — two-letter state code (e.g. CA, NY).
get_forecast — Get the weather forecast for a location.
- Input: latitude (-90 to 90), longitude (-180 to 180).
- Note: Only US locations are supported by the NWS API.

npm install

npm run build

This compiles TypeScript into the build/ directory and marks build/index.js as executable.

After building, run the server directly:

node build/index.js

You should see:

Weather MCP Server running on stdio

Configure your MCP client to launch this server. Example configuration:

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/absolute/path/to/weather/build/index.js"]
    }
  }
}

src/
  index.ts          # MCP server entry point, tool registration
  utils/
    helper.ts       # NWS API helpers and alert formatting