🌤️ Kaushik's Weather MCP Server

Ein produktionsreifer Model Context Protocol (MCP)-Server, geschrieben in TypeScript, der LLMs (wie Claude Desktop, Cursor und benutzerdefinierte KI-Agenten) mit Echtzeit-Wetterdaten des National Weather Service (NWS / NOAA) verbindet.

🔗 Live-Integrationsnachweis

🚀 Verifiziert funktionierend mit Claude Desktop: Schauen Sie sich die Live-Chat-Sitzung an, die Echtzeit-Vorhersageabruf, Warnungen und Gesundheitsdiagnosen demonstriert:
👉 Live-Claude-AI-Chat-Nachweis ansehen

Related MCP server: mcp-weather

✨ Architektur-Highlights

• 🏗️ Modulare saubere Architektur: Entkoppelt in dedizierte Service-Schichten (CacheService, RateLimiterService, NwsClient, Logger, Formatter).

• 📡 Offizielle meteorologische Bulletins: Strukturierte Wetterberichte mit standardisierten Metadaten und Herkunftsangabe.

• ⚡ In-Memory-Caching (5-Min-TTL): Thread-sicherer In-Memory-Cache, der den Upstream-API-Verkehr um bis zu 80 % reduziert.

• 🛡️ Zero-Vibe-Sicherheitsschicht: Strikte Eingabebereinigung, XSS-Entity-Escaping und client-isoliertes Rate-Limiting (100 Anfragen/min).

• 🔁 Resilienz & Fehlertoleranz: Automatisierte exponentielle Backoff-Wiederholungen für HTTP-5xx-/429-Fehler und Anforderungs-Timeout-Schutz.

• 🩺 Beobachtbarkeit & Diagnose: Integrierte health_check-, get_metrics- und clear_cache-Werkzeuge mit strukturierter JSON-Protokollierung.

📁 Projektstruktur

weather/
├── src/
│   ├── config/          # Central configuration & runtime constants
│   ├── services/        # Core business logic (Cache, RateLimiter, NwsClient, Formatter, Logger)
│   ├── tools/           # MCP Tool handlers (alerts, forecast, diagnostics)
│   ├── types/           # Strongly typed TypeScript interfaces
│   ├── utils/           # Input sanitization and security helpers
│   └── index.ts         # Server bootstrap, transport initialization & graceful shutdown
├── tests/
│   ├── unit/            # Unit test suites (utils, sanitizer, cache)
│   ├── integration/     # Upstream NWS API integration & retry tests
│   ├── performance/     # Cache throughput & rate-limiting load tests
│   ├── security/        # XSS, injection prevention & boundary tests
│   └── basic.test.ts    # Comprehensive test runner
├── build/               # Compiled ES module JavaScript distribution
├── package.json
└── tsconfig.json

🛠️ MCP-Werkzeuge

🚀 Erste Schritte

1. Klonen und installieren

git clone https://github.com/Kaushik2105/mcp-weather.git
cd mcp-weather
npm install

2. Erstellen

npm run build

3. Testsuite ausführen

npm test

🔌 Verbinden mit Claude Desktop

Fügen Sie diese Konfiguration zu Ihrer Claude-Desktop-Konfigurationsdatei hinzu:

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

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

{
  "mcpServers": {
    "kaushik-weather": {
      "command": "node",
      "args": [
        "c:/Workholic/LawSikho/POCs/weather/weather/build/index.js"
      ]
    }
  }
}

Hinweis: Starten Sie Claude Desktop neu, nachdem Sie die Konfiguration gespeichert haben.

💬 Beispiel-Prompts für Claude

• "Zeig mir das offizielle Vorhersage-Bulletin von Kaushiks Wetter-Tool für Los Angeles (Lat: 34.0522, Lon: -118.2437)"

• "Gibt es aktive Wetterwarnungen für Florida (FL)?"

• "Führe eine Gesundheitscheck-Diagnose auf Kaushiks Wetter-MCP-Server durch."

👨💻 Autor

Kaushik Karmakar

• GitHub: @Kaushik2105

• Live-Integrationsnachweis: Claude AI Chat