Weather MCP Server

A simple MCP (Model Context Protocol) weather server written in TypeScript that provides weather alerts and forecasts using the National Weather Service API. This server can be easily accessed by multiple users via npx.

Features

• Get weather alerts for any US state
• Get weather forecasts for any US location by latitude and longitude
• Compatible with Windsurf and other MCP clients
• Easy to use with npx

Quick Start

For Windsurf Users

Add this to your Windsurf MCP configuration (typically found at ~/.codeium/windsurf/mcp_config.json):

{
  "mcp_servers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "@yourusername/weather-mcp@latest"],
      "transport": "stdio"
    }
  }
}

Replace @yourusername with the actual npm username of the publisher.

Using npx Directly

Run directly without installation:

npx @yourusername/weather-mcp

Installing globally

npm install -g @yourusername/weather-mcp
weather-mcp

Manual Configuration with Windsurf

To manually configure this weather server with Windsurf:

1. Open Windsurf settings
2. Navigate to the MCP servers section
3. Add a new MCP server with:
   • Name: "weather"
   • Path: npx -y @yourusername/weather-mcp@latest
   • Transport: stdio

Available Tools

get-alerts

Get weather alerts for a US state using a two-letter state code.

Parameters:

• state: Two-letter state code (e.g., CA, NY)

get-forecast

Get weather forecast for a location using latitude and longitude.

Parameters:

• latitude: Latitude of the location (-90 to 90)
• longitude: Longitude of the location (-180 to 180)

Development

# Clone the repository
git clone <repository-url>
cd windsurf-weather-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run locally
npm start

Publishing to npm

To make this MCP server available to multiple users via npx, follow these steps to publish it to npm:

1. Create an npm account if you don't have one at npmjs.com

2. Choose a unique package name - The package name in package.json should be unique. Using a scoped name with your username (e.g., @yourusername/weather-mcp) is recommended.

3. Login to npm from your terminal:

   npm login

4. Publish your package:

   npm publish --access public

   Note: The --access public flag is required for scoped packages (starting with @username/).

5. Update version for future releases:

   When making changes, update the version in package.json and publish again:

   # After making changes
   npm version patch # or minor or major
   npm publish --access public

See the INSTALL.md file for more detailed installation instructions.

For more information about the Model Context Protocol, see the MCP documentation.