mcp-weather

mcp-weather

Accurate weather forecasts via the AccuWeather API (free tier available).

28
Stars
10
Forks
0
Releases

Overview

This MCP Weather Server exposes real-time weather data to large language models and other MCP-compatible clients by offering two tools: weather-get_hourly and weather-get_daily. It uses the AccuWeather API (free tier available) and requires an API key provided via the ACCUWEATHER_API_KEY environment variable. The hourly tool returns forecasts for the next 12 hours, while the daily tool provides forecasts for up to 15 days. Both tools support location-based queries and optional units (metric or imperial). The server can display data in °C or °F and includes temperature, conditions, precipitation, and other weather details. It can be run locally with npx and also exposed via HTTP/REST through Supergateway for integration with Claude Desktop or other MCP clients. Prerequisites include Node.js ≥18 and an AccuWeather API key. Setup steps involve cloning the repository, installing dependencies, creating a .env file with the API key, and building the project. This makes it easy for Claude Desktop users and other developers to fetch up-to-date weather information in conversations with an MCP-enabled interface.

Details

Owner
TimLukaHorstmann
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Hourly Weather Forecast (tool: weather-get_hourly)

Provides hourly forecasts for the next 12 hours with required location and optional units (metric or imperial).

Daily Weather Forecast (tool: weather-get_daily)

Provides daily forecasts for up to 15 days with location, optional days and units (metric or imperial).

Real-time Data Access for LLMs

Enables large language models to fetch up-to-date weather data during conversations.

Unit Support

Displays data in metric (°C) or imperial (°F) units.

Location-based Queries

Forecast tools accept a location parameter to fetch data for a city or location name.

Multiple Access Methods

Run the MCP server via NPX locally or expose it via HTTP/REST using Supergateway.

AccuWeather API Key Management

Uses ACCUWEATHER_API_KEY provided via environment variables for authentication.

Setup and Build Workflow

Clone, install, create .env, and build with npm to run the server.

Audience

LLMsAccess real-time weather data through the MCP server to answer weather queries.
DevelopersIntegrate into Claude Desktop, Supergateway, or other MCP-compatible clients for weather data.

Tags

weatherAccuWeatherhourlydailyforecastMCPClaudeLLMreal-timeAPI keynodejs