mcp-weather-server by Ankesh-53669 - MCP Server

🌤️ MCP Weather Server

This is a lightweight MCP (Model Context Protocol) server built using FastMCP. It connects with Claude for Desktop and exposes useful tools like:

🌦️ US weather forecasts and alerts

📋 Features

Tool	Description
`get_forecast`	Fetches a 5-period weather forecast by coordinates
`get_alerts`	Lists current weather alerts for a US state

🧰 Prerequisites

Python 3.10 or later
Claude for Desktop
uv (Python package manager)
Git

⚙️ Setup Instructions

1. 📥 Install Claude for Desktop

Download and install from:
👉 https://www.anthropic.com/claude

Once installed, open Claude once to generate its configuration directory.

2. 📦 Install `uv` (one-time setup)

Open PowerShell and run:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Then restart your terminal, or run:

$env:Path = "C:\Users\admin\.local\bin;$env:Path"

3. 📁 Clone the Repository

git clone https://github.com/your-username/mcp-weather-and-quotes.git
cd mcp-weather-and-quotes

4. 🐍 Set Up Python Environment

uv venv
.venv\Scripts\activate         # On Windows
# OR
source .venv/bin/activate        # On macOS/Linux

uv add mcp[cli] httpx

5. 🧠 Configure Claude to Detect the MCP Server

Open this file in VS Code or Notepad:

code "$env:AppData\Claude\claude_desktop_config.json"

If the file doesn’t exist, create it. Then paste the following JSON configuration:

{
  "mcpServers": {
    "weather": {
      "command": "C:\\Users\\admin\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\admin\\mcp-weather-and-quotes",
        "run",
        "weather.py"
      ]
    }
  }
}

🔁 Make sure all paths are correct and absolute. Use double backslashes (\\) or forward slashes (/).

6. ▶️ Run the MCP Server

From the project directory, run:

uv run weather.py

This will start your MCP server using STDIO.

🧪 Using the Tools in Claude

Restart Claude for Desktop
Click the slider icon (top-right) to open Tools
You should see the following tools:
- get_forecast
- get_alerts

💬 Example Prompts to Try

"What's the forecast for 38.58, -121.49?"
"Any active alerts in Texas?"

Claude will automatically decide whether to call your tool and display the result.

📂 Project Structure

mcp-weather-and-quotes/
├── weather.py                # Main MCP server code
├── README.md                 # This file
└── .venv/                    # Virtual environment (optional)

🙏 APIs Used

US Weather: https://api.weather.gov

📝 License

MIT License – use it, share it, extend it!

Ankesh-53669/mcp-weather-server