MCP Weather Server

What is MCP Weather Server about?

MCP Weather Server delivers real‑time weather data—hourly forecasts for the next 12 hours and daily forecasts for up to 15 days—by querying the AccuWeather API. It exposes two tools (weather-get_hourly and weather-get_daily) that LLMs can invoke to obtain accurate, location‑based forecasts in metric or imperial units.

How to use MCP Weather Server?

Obtain an AccuWeather API key (free tier available).
Set the key as an environment variable ACCUWEATHER_API_KEY.
Run the server directly:
```
npx -y @timlukahorstmann/mcp-weather
```
Or launch it behind Supergateway for HTTP/REST access.
Add the server to an MCP‑compatible client (e.g., Claude Desktop) using the provided configuration JSON.
Invoke the tools weather-get_hourly or weather-get_daily from the LLM prompt, supplying location, units, and optionally days.

Key features of MCP Weather Server

Hourly forecasts for the next 12 hours.
Daily forecasts for 1, 5, 10, or 15 days.
Metric (°C) and imperial (°F) unit support.
Simple CLI execution via npx.
Ready‑to‑use configuration for Claude Desktop and other MCP clients.
TypeScript codebase with linting, testing, and build scripts.

Use cases of MCP Weather Server

Enabling conversational agents to answer weather‑related questions.
Building bots that provide travel or event planning assistance with up‑to‑date forecasts.
Integrating weather data into AI‑driven decision support systems.
Supplying LLMs with contextual weather information for more realistic scenario generation.

FAQ from the MCP Weather Server

Q: Do I need a paid AccuWeather plan? A: No. The free tier provides sufficient calls for development and moderate usage.

Q: Which Node.js version is required? A: Node.js 18 or later.

Q: How many forecast days can I request? A: Up to 15 days; the days parameter accepts 1, 5, 10, or 15.

Q: Can I change the default units? A: Yes. Pass units: "imperial" for Fahrenheit or omit for the default Celsius.

Q: Is a session ID required? A: No. Since version 0.4.0 the tools no longer require a sessionId.

Q: How do I run the server behind a gateway? A: Use the supplied Supergateway command‑line example, which forwards STDIO and sets the required environment variable.

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:

export ACCUWEATHER_API_KEY=your_api_key_here

Then run the MCP Weather server directly with:

npx -y @timlukahorstmann/mcp-weather

Or, for HTTP/REST access via supergateway:

npx -y supergateway --stdio "npx -y @timlukahorstmann/mcp-weather" \
  --port 4004 \
  --baseUrl http://127.0.0.1:4004 \
  --ssePath /messages \
  --messagePath /message \
  --cors "*" \
  --env ACCUWEATHER_API_KEY="$ACCUWEATHER_API_KEY"

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):

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "@timlukahorstmann/mcp-weather"],
      "env": {
        "ACCUWEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

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

Available Tools

Hourly Weather Forecast

Tool name: weather-get_hourly
Provides hourly forecasts for the next 12 hours
Parameters:
- 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:
- 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)

Prerequisites

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

Setup

Clone this repository:

git clone https://github.com/TimLukaHorstmann/mcp-weather.git
cd mcp-weather

Install dependencies:
```
npm install
```
Get an AccuWeather API key:
- Register at AccuWeather API
- Create a new app and obtain an API key
Create a .env file with your API key:
```
ACCUWEATHER_API_KEY=your_api_key_here
```
Build the project:
```
npm run build
```

Usage with Claude Desktop

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"
      }
    }
  }
}

Restart Claude Desktop
In a new conversation, enable the MCP server by clicking the plug icon and selecting "weather"
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?"

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!

Changelog

0.4.0

Removed sessionId requirement from all tools as it was not used for anything internally
This simplifies integrations and reduces confusion for LLM usage

0.3.0 and earlier

Initial releases with basic functionality

License

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

MCP Weather Server