MCP Weather Server

A Model Context Protocol (MCP) server that provides weather information tools and resources.

Features

• Current Weather: Get real-time weather conditions for any location
• Weather Forecast: 5-day weather forecast with detailed information
• Location Support: Major world cities, coordinates, and ZIP codes
• Units: Support for both Celsius and Fahrenheit
• Resources: Weather location data and API information
• Prompts: Weather summary generation for activity planning

Tools

get_current_weather

Get current weather information for a location.

Parameters:

• location (required): City name, coordinates, or ZIP code
• units (optional): "celsius" or "fahrenheit" (default: celsius)

get_weather_forecast

Get multi-day weather forecast for a location.

Parameters:

• location (required): City name, coordinates, or ZIP code
• days (optional): Number of days (1-5, default: 3)

Resources

• weather://locations: List of supported locations and formats
• weather://api-info: Weather API and data source information

Prompts

• weather_summary: Generate weather summary for activity planning

Usage

With Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sse"],
      "env": {
        "SSE_URL": "https://your-server.fly.dev/mcp"
      }
    }
  }
}

Local Development

npm install
npm start

Docker Deployment

docker build -t mcp-weather-server .
docker run -p 8080:8080 mcp-weather-server

Health Check

The server includes a health check endpoint at /health that returns server status and version information.

License

MIT