weather-mcp

A weather MCP server powered by WeatherAPI. Works with Claude and any MCP-compatible client.

Installation

pip install weather-mcp-v1

Setup

1. Get a free API key from weatherapi.com
2. Create a .env file in your working directory:

WEATHER_API_KEY=your_api_key_here

Or set it as an environment variable:

# Linux/Mac
export WEATHER_API_KEY=your_api_key_here

# Windows (PowerShell)
$env:WEATHER_API_KEY="your_api_key_here"

Usage

The server supports two transport modes — stdio for local development and SSE for remote/production deployment.

Mode 1 — stdio (Local Development)

No separate server process needed. The client spawns and manages the server automatically.

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

server_params = StdioServerParameters(
    command="python",
    args=["-m", "weather_mcp.server"],
    env={"WEATHER_API_KEY": "your_api_key_here"}
)

async with stdio_client(server_params) as (read, write):
    async with ClientSession(read, write) as session:
        await session.initialize()
        tools = await session.list_tools()

Mode 2 — SSE (Remote / Production)

Run the server independently and connect to it over HTTP.

Start the server:

# Linux/Mac
MCP_TRANSPORT=sse weather-mcp

# Windows (PowerShell)
$env:MCP_TRANSPORT="sse"; weather-mcp

Server starts at http://localhost:8000/sse

Connect from your client:

from mcp.client.sse import sse_client
from mcp import ClientSession

async with sse_client("http://localhost:8000/sse") as (read, write):
    async with ClientSession(read, write) as session:
        await session.initialize()
        tools = await session.list_tools()

When hosted remotely, just change the URL:

async with sse_client("https://your-server.railway.app/sse") as (read, write):
    ...

Connect with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "weather": {
      "command": "weather-mcp",
      "env": {
        "WEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Environment Variables

Available Tools

get_weather

Fetches current weather for a given location.

Input:

• location (string) — city name, postal code, or coordinates (e.g. "New York", "10001", "48.8566,2.3522")

Output: Full weather JSON from WeatherAPI including:

• Temperature (Celsius and Fahrenheit)
• Condition and description
• Humidity, wind speed, visibility
• Feels like temperature

License

MIT