mcpField
W
Weather MCP Server

Weather MCP Server

Local
github.com/CodeByWaqasMedia & Design5Updated 82w ago
Repository

About Weather MCP Server

Weather MCP Server provides real-time weather information through the OpenWeatherMap API for MCP clients. It returns metric temperatures, humidity, wind speed, sunrise and sunset times, and weather descriptions.

Key features

  1. 01Real-time weather lookup
  2. 02Metric temperature data
  3. 03Humidity and wind details
  4. 04Sunrise and sunset times
  5. 05Weather descriptions

Use cases

  1. 01Ask for current weather in a conversation
  2. 02Check temperatures and humidity
  3. 03Retrieve wind and sunrise or sunset details

MCP support

The MCP server exposes OpenWeatherMap weather information to MCP clients. An OpenWeatherMap API key is required.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "weather-mcp-server-codebywaqas": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Weather MCP Server

smithery badge

A Modern Code Protocol (MCP) server that provides weather information using the OpenWeatherMap API.

Features

  • Real-time weather data retrieval
  • Metric units for temperature
  • Detailed weather information including:
    • Temperature
    • Humidity
    • Wind Speed
    • Sunrise/Sunset times
    • Weather description

Prerequisites

  • Python 3.12 or higher
  • OpenWeatherMap API key

Installation

Installing via Smithery

To install Weather MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @CodeByWaqas/weather-mcp-server --client claude
Manual Installation
  1. Clone the repository
  2. Create a virtual environment:
python -m venv .venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate
  1. Install dependencies:
pip install -e .

Setup Intructions

Setup with Claude Desktop
# claude_desktop_config.json
# Can find location through:
# Claude -> Settings -> Developer -> Edit Config
{
  "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"
          }
      }
  }
}

Local/Dev Setup Instructions

Clone repo

git clone https://github.com/CodeByWaqas/weather-mcp-server

Install dependencies

Install MCP server dependencies:

cd weather-mcp-server

# Create virtual environment and activate it
uv venv

source .venv/bin/activate # MacOS/Linux
# OR
.venv/Scripts/activate # Windows

# Install dependencies
uv add "mcp[cli]" python-dotenv requests httpx

Configuration

  1. Copy src/resources/env.example to src/resources/.env
  2. Add your OpenWeatherMap API key to the .env file:
WEATHER_API_KEY=your_api_key_here

Usage

Run the Claude Desktop and use LLM to retrieve weather info

License

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.