Weather MCP Server

An MCP server providing worldwide weather via the free Open-Meteo APIs (no API key needed). Runs fully self-contained in Docker as a streamable-HTTP MCP service.

Tools

Related MCP server: EightyAndSunny

Run with Docker

docker compose up -d --build

The MCP endpoint is then at http://localhost:8100/mcp and a liveness probe at http://localhost:8100/health. (Host port defaults to 8100 since 8000 is often taken by other MCP containers; override with MCP_HOST_PORT.)

Check status / logs:

docker compose ps          # health column shows "healthy" once up
docker compose logs -f weather-mcp

Stop:

docker compose down

Configuration (environment variables)

Connect an MCP client

Claude Code:

claude mcp add --transport http weather http://localhost:8100/mcp

Claude Desktop (claude_desktop_config.json), via mcp-remote:

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8100/mcp"]
    }
  }
}

Run locally without Docker (stdio)

pip install -r requirements.txt
python weather_server.py

With the default MCP_TRANSPORT=stdio, an MCP client launches the script itself:

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["D:/Local Development/Weather MCP Server/weather_server.py"]
    }
  }
}