# devilcoder01/weather-mcp-server [Health: Active]

**Category:** 🗺️ Location Services  
**Repository:** https://github.com/devilcoder01/weather-mcp-server  
**GitHub Stars:** 24  
**npm Downloads (last month):** 30651  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/devilcoder01-weather-mcp-server

## Description
Access real-time weather data for any location using the WeatherAPI.com API, providing detailed forecasts and current conditions.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "weather-mcp-server": {
    "command": "npx",
    "args": ["-y","@smithery/cli"],
    "env": {
      "WEATHER_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `WEATHER_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What devilcoder01/weather-mcp-server MCP server does

The devilcoder01/weather-mcp-server MCP server gives MCP-compatible assistants access to weather information from WeatherAPI.com. Its documented coverage includes both current and historical conditions, forecasts ranging from one to fourteen days, weather alerts, air quality, astronomy details, location lookup, time zones, and sports events.

This makes it suitable for assistants that need to answer location-based weather questions or combine weather data with planning and informational workflows. The source material does not specify individual MCP tool names or their exact input and output schemas, so integrations should be evaluated against the server's implementation before depending on a particular operation.

## How it works

The project is implemented in Python using FastAPI and an MCP framework. A client connects to the locally running server, and the server uses the configured WeatherAPI.com credential to retrieve weather-related data. The documented default address is `http://localhost:8000`.

Requests depend on the WeatherAPI service and an API key supplied by the operator. The README does not document caching, persistence, rate-limit handling, response transformation, or a remote hosted endpoint.

## Setup and configuration

The documented prerequisites are Python 3.13 or newer, the `uv` package manager, and a WeatherAPI API key. Manual setup starts by cloning the repository, entering the project directory, creating a virtual environment with `uv venv`, and installing the project in editable mode with `uv pip install -e .`.

Create a `.env` file in the project root and set the required variable:

```dotenv
WEATHER_API_KEY=your_api_key_here
```

The devilcoder01/weather-mcp-server MCP server is started with `python main.py`. According to the README, it listens on port 8000 by default. The project also documents Smithery installation for Claude Desktop, but that route uses the Smithery CLI rather than a direct project command.

## Tools and capabilities

Documented data areas include:

- Current weather conditions
- One- to fourteen-day forecasts
- Historical weather data
- Weather alerts
- Air quality information
- Sunrise, sunset, and moon-phase data
- Location search
- Time zone information
- Sports events

These capabilities are described at the feature level; the supplied material does not provide a complete tool list, parameter reference, or example MCP calls.

## Limitations and notes

A WeatherAPI.com API key is required, and the source material does not state whether a free or paid WeatherAPI plan is needed. Python 3.13 or later and uv are also listed as requirements. The README identifies Claude Desktop as a Smithery installation target, but it does not explicitly list compatibility with other MCP clients. No hosted service URL is provided, so the documented usage is local execution.

The repository states that it is licensed under MIT. Forecast coverage is documented as one to fourteen days, while historical data, alerts, air quality, astronomy, location, time zone, and sports-event support are listed without further scope or retention details.

_Full upstream README: https://allmcps.com/mcp/devilcoder01-weather-mcp-server/readme_