mcp-python

A Model Context Protocol (MCP) server that exposes US weather data — via the National Weather Service API — as tools, resources, and prompts for MCP-compatible clients like Claude Desktop.

Features

Tools

• get_alerts(state) — active weather alerts for a two-letter US state code (e.g. CA, NY)
• get_forecast(latitude, longitude) — forecast for the next 5 periods at a given location

Resources

• weather://states — list of valid two-letter US state codes
• weather://alerts/{state} — alerts for any state, as a readable resource
• Static alert resources for CA, NY, TX, FL (so they're attachable from Claude Desktop's picker, which only lists static resources)

Prompts

• weather_briefing(state) — concise severe weather briefing for a state
• trip_packing_advice(latitude, longitude) — packing advice based on the forecast for a location

Requirements

• Python >= 3.11
• uv

Setup

uv sync

Running the server

uv run weather.py

The server communicates over stdio, so it's meant to be launched by an MCP client rather than run standalone.

Using with Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/mcp-python",
        "run",
        "weather.py"
      ]
    }
  }
}

Restart Claude Desktop and the weather tools, resources, and prompts will be available.

Project structure

• weather.py — the MCP server (tools, resources, prompts)
• main.py — placeholder entrypoint from the project template
• pyproject.toml / uv.lock — dependencies, managed with uv