🌦️ Saige Weather MCP Server

A lightweight, production-ready Model Context Protocol (MCP) server that delivers real-time weather information for any city or country worldwide using the free Open-Meteo API.

Compatible with Claude Desktop, Cursor, Windsurf, and custom AI agent workflows (LangChain, Groq, AutoGen).

✨ Features

• 🌍 Worldwide Coverage: Query weather for any city, country, or location worldwide (e.g., Tokyo, London, Paris, Mumbai, New York).

• 🔑 Zero API Keys Required: Uses Open-Meteo’s public geocoding and forecast APIs out of the box.

• ⚡ Instant Execution with uvx: Run immediately from PyPI without manual dependency installation or virtual environment clutter.

• 🔌 Multiple Transports Supported: Supports standard input/output (stdio) for desktop AI clients and Server-Sent Events (SSE) for network deployments.

Related MCP server: MCP Weather Server

🚀 Quick Start

1. Using directly with uvx (No installation needed)

You can launch and test the server immediately with Astral's uvx:

uvx saige-weather-mcp

Or test it interactively with the MCP Inspector:

npx @modelcontextprotocol/inspector uvx saige-weather-mcp

2. Adding to Claude Desktop

Add the following to your claude_desktop_config.json:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "weather": {
      "command": "uvx",
      "args": ["saige-weather-mcp"]
    }
  }
}

Restart Claude Desktop, and the hammer icon (🛠️) will appear with the get_weather tool available in your chat!

3. Using in Custom AI Assistants (e.g. LangChain / Groq)

In your MCP configuration file (e.g. browser_mcp.json):

{
  "mcpServers": {
    "weather": {
      "command": "uvx",
      "args": ["saige-weather-mcp"]
    }
  }
}

Then run your assistant (app.py):

from mcp_use import MCPClient, MCPAgent
from langchain_groq import ChatGroq

client = MCPClient("browser_mcp.json")
agent = MCPAgent(llm=ChatGroq(model_name="openai/gpt-oss-120b"), client=client)

🛠️ Tools Provided

get_weather

Fetch live atmospheric conditions for any location.

• Parameter:

  • location (string, required): The city, country, or landmark name. (e.g. "London", "Tokyo", "Paris").

• Example Output:

  Weather for London, United Kingdom:
  - Temperature: 10.2 °C
  - Humidity: 88%
  - Wind Speed: 12.4 km/h

💻 Local Development

If you want to contribute or modify this project locally:

1. Clone the repository:

   git clone https://github.com/hackershanmukha/mcp-weather.git
   cd mcp-weather

2. Install dependencies using uv:

   uv sync

3. Run the development server with Inspector:

   uv run mcp dev --with "mcp[cli]" server/wheater.py

📄 License

This project is open-source and available under the MIT License.