MCP Weather Server

1# MCP Weather Server
2 
3[![npm version](https://img.shields.io/npm/v/@timlukahorstmann/mcp-weather)](https://www.npmjs.com/package/@timlukahorstmann/mcp-weather)
4[![license](https://img.shields.io/github/license/TimLukaHorstmann/mcp-weather)](https://github.com/TimLukaHorstmann/mcp-weather/blob/main/LICENSE)
5[![node version](https://img.shields.io/node/v/@timlukahorstmann/mcp-weather)](https://www.npmjs.com/package/@timlukahorstmann/mcp-weather)
6[![issues](https://img.shields.io/github/issues/TimLukaHorstmann/mcp-weather)](https://github.com/TimLukaHorstmann/mcp-weather/issues)
7[![weekly downloads](https://img.shields.io/npm/dm/@timlukahorstmann/mcp-weather)](https://www.npmjs.com/package/@timlukahorstmann/mcp-weather)
8[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/TimLukaHorstmann/mcp-weather)](https://archestra.ai/mcp-catalog/timlukahorstmann__mcp-weather)
9 
10<p align="center">
11  <img src="logo.png" alt="MCP Weather Server Logo" width="250"/>
12  <a href="https://glama.ai/mcp/servers/@TimLukaHorstmann/mcp-weather">
13    <img width="380" height="200" src="https://glama.ai/mcp/servers/@TimLukaHorstmann/mcp-weather/badge" alt="Weather MCP server" />
14  </a>
15</p>
16 
17A Model Context Protocol (MCP) server that provides hourly and daily weather forecasts using the AccuWeather API.
18 
19---
20 
21## Quick Start
22 
23You need an AccuWeather API key (free tier available).  
24[Sign up here](https://developer.accuweather.com/) and create an app to get your key.
25 
26Export your API key as an environment variable:
27 
28```bash
29export ACCUWEATHER_API_KEY=your_api_key_here
30```
31 
32Then run the MCP Weather server directly with:
33 
34```bash
35npx -y @timlukahorstmann/mcp-weather
36```
37 
38Or, for HTTP/REST access via [supergateway](https://github.com/supercorp-ai/supergateway):
39 
40```bash
41npx -y supergateway --stdio "npx -y @timlukahorstmann/mcp-weather" \
42  --port 4004 \
43  --baseUrl http://127.0.0.1:4004 \
44  --ssePath /messages \
45  --messagePath /message \
46  --cors "*" \
47  --env ACCUWEATHER_API_KEY="$ACCUWEATHER_API_KEY"
48```
49 
50---
51 
52## MCP Server Config Example
53 
54For integration with Claude Desktop or other MCP-compatible clients, add this to your config (e.g. `claude_desktop_config.json`):
55 
56```json
57{
58  "mcpServers": {
59    "weather": {
60      "command": "npx",
61      "args": ["-y", "@timlukahorstmann/mcp-weather"],
62      "env": {
63        "ACCUWEATHER_API_KEY": "your_api_key_here"
64      }
65    }
66  }
67}
68```
69 
70---
71 
72## Overview
73 
74This MCP server allows large language models (like Claude) to access real-time weather data. When integrated with an LLM, it enables the model to:
75 
76- Fetch accurate, up-to-date weather forecasts
77- Provide hourly weather data for the next 12 hours
78- Access daily weather forecasts for up to 15 days
79- Display data in both metric (°C) and imperial (°F) units
80- View temperature, conditions, precipitation information, and other weather details
81 
82## Available Tools
83 
84### Hourly Weather Forecast
85- Tool name: `weather-get_hourly`
86- Provides hourly forecasts for the next 12 hours
87- Parameters:
88  - `location` (required): City or location name
89  - `units` (optional): "metric" (Celsius, default) or "imperial" (Fahrenheit)
90 
91### Daily Weather Forecast
92- Tool name: `weather-get_daily`
93- Provides daily forecasts for up to 15 days
94- Parameters:
95  - `location` (required): City or location name
96  - `days` (optional): Number of forecast days (1, 5, 10, or 15; default is 5)
97  - `units` (optional): "metric" (Celsius, default) or "imperial" (Fahrenheit)
98 
99## Prerequisites
100 
101- Node.js ≥18  
102- An AccuWeather API key (set via `.env` or your shell)
103 
104## Setup
105 
1061. **Clone this repository:**
107   ```bash
108   git clone https://github.com/TimLukaHorstmann/mcp-weather.git
109   cd mcp-weather
110   ```
111 
1122. **Install dependencies:**
113   ```bash
114   npm install
115   ```
116 
1173. **Get an AccuWeather API key:**
118   - Register at [AccuWeather API](https://developer.accuweather.com/)
119   - Create a new app and obtain an API key
120 
1214. **Create a `.env` file with your API key:**
122   ```
123   ACCUWEATHER_API_KEY=your_api_key_here
124   ```
125 
1265. **Build the project:**
127   ```bash
128   npm run build
129   ```
130 
131## Usage with Claude Desktop
132 
1331. Configure Claude Desktop to use this MCP server:
134   - Open Claude Desktop
135   - Go to Settings > Developer > Edit Config
136   - Add the following to your `claude_desktop_config.json`:
137 
138   ```json
139   {
140     "mcpServers": {
141       "weather": {
142         "command": "npx",
143         "args": ["-y", "@timlukahorstmann/mcp-weather"],
144         "env": {
145           "ACCUWEATHER_API_KEY": "your_api_key_here"
146         }
147       }
148     }
149   }
150   ```
151 
1522. Restart Claude Desktop
153 
1543. In a new conversation, enable the MCP server by clicking the plug icon and selecting "weather"
155 
1564. Now you can ask Claude for weather forecasts, such as:
157   - "What's the hourly weather forecast for New York City?"
158   - "Give me the 5-day forecast for London."
159   - "What will the weather be like in Tokyo this week in Fahrenheit?"
160   - "Will it rain in San Francisco tomorrow?"
161 
162## Development
163 
164- Install dev dependencies: `npm install`
165- Lint your code:           `npm run lint`  
166- Build:                    `npm run build`  
167- Run tests:                `npm test`
168- Start in dev mode:        `npm run dev`
169 
170## Contributing
171 
172Contributions are welcome! Please feel free to submit a Pull Request.
173 
174## Future Enhancements
175 
176We're always looking to improve the MCP Weather Server. Here are some features we're considering for future releases:
177 
178- **Extended Hourly Forecasts:** Beyond 12 hours, e.g., 24 or 48 hours.
179- **Weather Alerts:** Integration with AccuWeather's severe weather alerts API.
180- **Location Autocomplete:** Improved location searching with autocomplete suggestions.
181- **Historical Weather Data:** Access to past weather conditions.
182 
183If you have ideas for other features, feel free to open an issue!
184 
185## Changelog
186 
187### 0.4.0
188- Removed `sessionId` requirement from all tools as it was not used for anything internally
189- This simplifies integrations and reduces confusion for LLM usage
190 
191### 0.3.0 and earlier
192- Initial releases with basic functionality
193 
194## License
195 
196This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
197