Skip to main content
Glama
mcp-weather

mcp-weather

by Kaushik2105

🌤️ Kaushik's Weather MCP Server

TypeScript Model Context Protocol Node.js Tests Claude Verified License: ISC

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

Werkzeug

Parameter

Beschreibung

get_forecast

latitude (number), longitude (number)

Ruft Echtzeit-Vorhersagen für Zeiträume ab (Temperaturen, Winde, Bedingungen) für US-Koordinaten.

get_alerts

state (2-Buchstaben-US-Code, z. B. CA, NY, TX)

Ruft aktive Unwetterwarnungen, Warnungen und meteorologische Hinweise ab.

health_check

None

Gibt Laufzeitgesundheit, Betriebszeit, Heap-Speichernutzung, Cache-Größe und API-Verbindungsstatus zurück.

get_metrics

None

Gibt Leistungsdiagnosen und aktive Rate-Limit-Client-Buckets aus.

clear_cache

None

Leert den In-Memory-Cache und gibt die Anzahl der entfernten Einträge zurück.


🚀 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      Provides real-time US weather alerts and forecasts by integrating with the National Weather Service API. It enables AI assistants to fetch state-specific alerts and detailed local forecasts using geographic coordinates.
      2
      1
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time weather alerts and forecasts from the National Weather Service for US locations, integrating with AI assistants via the Model Control Protocol.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time weather alerts and forecasts for US locations by integrating with the National Weather Service API. Supports both server and client interactions with optional LLM summarization.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides weather forecasts and alerts for US locations via the National Weather Service API, enabling AI assistants to deliver real-time weather information.
      ISC