Codebywaqas Weather MCP Server

🚀 Weather MCP Server

A Modern Code Protocol (MCP) server that uses the OpenWeatherMap API to provide weather information.

🚀 Quick Start

This Weather MCP Server uses the OpenWeatherMap API to offer real - time weather information. You can install it via Smithery or manually, and then configure it to work with Claude Desktop.

✨ Features

• Fetch real - time weather data.
• Display temperature in degrees.
• Provide detailed weather information including:
  • Temperature
  • Humidity
  • Wind speed
  • Sunrise/Sunset time
  • Weather description

📦 Installation

Install via Smithery

Automatically install the Weather MCP Server for Claude Desktop through 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: .venv\Scripts\activate

3. Install the dependencies:

pip install -e .

📚 Documentation

Configuration for Use with Claude Desktop

# claude_desktop_config.json
# You can find the location via the path:
# Claude -> Settings -> Developer -> Edit Configuration
{
  "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"
          }
      }
  }
}

Development/Local Setup Instructions

Clone the repository

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

Install the dependencies

Install the dependencies for the MCP server:

cd weather-mcp-server

# Create a 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 Examples

Basic Usage

Run Claude Desktop and use the LLM to get weather information.

📄 License

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