Weather

You can run Weather MCP Server to fetch real-time weather data from OpenWeatherMap for any compatible MCP client. It provides temperature, humidity, wind, sunrise/sunset times, and weather descriptions in metric units, making weather-aware applications simple to build and deploy.

How to use

To use Weather MCP Server, run it locally or remotely and connect an MCP client to it. You provide your OpenWeatherMap API key, and the server will respond with current weather details for requested locations. When you integrate with a Claude Desktop workflow, you configure it to start the server process and pass the API key securely. Use the server to fetch weather data on demand, enabling dynamic weather-aware interactions in your applications.

How to install

Prerequisites you need before installation are Python 3.12 or higher and an OpenWeatherMap API key.

Manual installation steps you can follow now:

# 1) Clone the repository
git clone https://github.com/CodeByWaqas/weather-mcp-server

# 2) Create a virtual environment and activate it
python -m venv .venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate

# 3) Install dependencies in editable mode
pip install -e .

Configuration and setup for Claude Desktop

If you use Claude Desktop, configure the MCP server so it starts alongside Claude and uses your API key. The following JSON config demonstrates how to start the local server process via the uv tool and pass your API key as an environment variable.

{
  "mcpServers": {
      "mcp-weather-project": {
          "command": "uv",
          "args": [
              "--directory",
              "/<absolute-path>/weather-mcp-server/src/resources",
              "run",
              "server.py"
          ],
          "env": {
            "WEATHER_API_KEY": "YOUR_API_KEY"
          }
      }
  }
}

Additional setup notes

Environment file setup helps keep keys out of source control. Copy the example environment file and insert your OpenWeatherMap API key. After cloning the repository, create a file at src/resources/.env with the WEATHER_API_KEY value.