src/
├── index.ts              # Entry point — starts the MCP server
├── server.ts             # Creates MCP server and registers all tools
│
├── config/
│   └── constants.ts      # API URLs, app name, timezone
│
├── types/
│   ├── nws.ts            # TypeScript types for US (NWS) API
│   └── open-meteo.ts     # TypeScript types for Open-Meteo API
│
├── utils/
│   ├── fetch.ts          # HTTP request helper
│   ├── location.ts       # US location detection
│   └── weather-codes.ts  # WMO weather code → readable text
│
├── formatters/
│   ├── alerts.ts         # Formats alert data into readable text
│   └── open-meteo.ts     # Formats forecast data into readable text
│
├── services/
│   ├── nws.service.ts        # US weather API calls
│   └── open-meteo.service.ts # India/global weather API + geocoding
│
└── tools/
    ├── index.ts                  # Registers all MCP tools
    ├── get-alerts.tool.ts        # US alerts tool
    ├── get-forecast.tool.ts      # Coordinates-based forecast tool
    └── get-india-weather.tool.ts # Indian city weather tool

User / AI
   │
   ▼
index.ts          → starts server on stdio
   │
   ▼
server.ts         → creates McpServer, calls registerTools()
   │
   ▼
tools/            → handles MCP tool request (e.g. get_india_weather)
   │
   ▼
services/         → calls external API (NWS or Open-Meteo)
   │
   ▼
formatters/       → converts raw JSON into readable text
   │
   ▼
Response          → sent back to AI via MCP

flowchart TD
    A[User / AI] --> B[index.ts]
    B --> C[server.ts]
    C --> D[tools/]
    D --> E[services/]
    E --> F[External APIs]
    F --> G[formatters/]
    G --> H[MCP Response]

npm install
npm run build

npm start

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/absolute/path/to/weather/build/index.js"]
    }
  }
}