MCP Weather

MCP Weather Server

A Model Context Protocol (MCP) server that provides hourly and daily weather forecasts using the AccuWeather API.

Quick Start

You need an AccuWeather API key (free tier available).
Sign up here and create an app to get your key.

Export your API key as an environment variable:

Then run the MCP Weather server directly with:

Or, for HTTP/REST access via supergateway:

MCP Server Config Example

For integration with Claude Desktop or other MCP-compatible clients, add this to your config (e.g. claude_desktop_config.json):

Overview

This MCP server allows large language models (like Claude) to access real-time weather data. When integrated with an LLM, it enables the model to:

• Fetch accurate, up-to-date weather forecasts
• Provide hourly weather data for the next 12 hours
• Access daily weather forecasts for up to 15 days
• Display data in both metric (°C) and imperial (°F) units
• View temperature, conditions, precipitation information, and other weather details

Prerequisites

• Node.js ≥18
• An AccuWeather API key (set via .env or your shell)

Setup

1. Clone this repository:
   git clone https://github.com/TimLukaHorstmann/mcp-weather.git cd mcp-weather
2. Install dependencies:
   npm install
3. Get an AccuWeather API key:
   • Register at AccuWeather API
   • Create a new app and obtain an API key
4. Create a .env file with your API key:
   ACCUWEATHER_API_KEY=your_api_key_here
5. Build the project:
   npm run build

Usage with Claude Desktop

1. Configure Claude Desktop to use this MCP server:
   • Open Claude Desktop
   • Go to Settings > Developer > Edit Config
   • Add the following to your claude_desktop_config.json:
   { "mcpServers": { "weather": { "command": "npx", "args": ["-y", "@timlukahorstmann/mcp-weather"], "env": { "ACCUWEATHER_API_KEY": "your_api_key_here" } } } }
2. Restart Claude Desktop
3. In a new conversation, enable the MCP server by clicking the plug icon and selecting "weather"
4. Now you can ask Claude for weather forecasts, such as:
   • "What's the hourly weather forecast for New York City?"
   • "Give me the 5-day forecast for London."
   • "What will the weather be like in Tokyo this week in Fahrenheit?"
   • "Will it rain in San Francisco tomorrow?"

Available Tools

Hourly Weather Forecast

• Tool name: weather-get_hourly
• Provides hourly forecasts for the next 12 hours
• Parameters:
  • sessionId (required): Unique identifier for the session
  • location (required): City or location name
  • units (optional): "metric" (Celsius, default) or "imperial" (Fahrenheit)

Daily Weather Forecast

• Tool name: weather-get_daily
• Provides daily forecasts for up to 15 days
• Parameters:
  • sessionId (required): Unique identifier for the session
  • location (required): City or location name
  • days (optional): Number of forecast days (1, 5, 10, or 15; default is 5)
  • units (optional): "metric" (Celsius, default) or "imperial" (Fahrenheit)

Development

• Install dev dependencies: npm install
• Lint your code: npm run lint
• Build: npm run build
• Run tests: npm test
• Start in dev mode: npm run dev

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Future Enhancements

We're always looking to improve the MCP Weather Server. Here are some features we're considering for future releases:

• Extended Hourly Forecasts: Beyond 12 hours, e.g., 24 or 48 hours.
• Weather Alerts: Integration with AccuWeather's severe weather alerts API.
• Location Autocomplete: Improved location searching with autocomplete suggestions.
• Historical Weather Data: Access to past weather conditions.

If you have ideas for other features, feel free to open an issue!

License

This project is licensed under the MIT License - see the LICENSE file for details.