mcp-weather
🌤️ 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- undclear_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 |
|
| Ruft Echtzeit-Vorhersagen für Zeiträume ab (Temperaturen, Winde, Bedingungen) für US-Koordinaten. |
|
| Ruft aktive Unwetterwarnungen, Warnungen und meteorologische Hinweise ab. |
| None | Gibt Laufzeitgesundheit, Betriebszeit, Heap-Speichernutzung, Cache-Größe und API-Verbindungsstatus zurück. |
| None | Gibt Leistungsdiagnosen und aktive Rate-Limit-Client-Buckets aus. |
| 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 install2. Erstellen
npm run build3. 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.jsonmacOS:
~/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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
US NWS weather alerts and 5-day forecasts for AI agents. $0.01 per call.
US weather & geo for AI agents: forecasts, alerts, earthquakes, elevation, geocoding. No keys.
US weather & geo for AI agents: forecasts, alerts, earthquakes, elevation, geocoding. No keys.
Get US weather forecasts, active and recent alerts, and current observations.
Related MCP Servers
- FlicenseBqualityDmaintenanceProvides 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.21-
- FlicenseNot gradedqualityDmaintenanceProvides real-time weather alerts and forecasts from the National Weather Service for US locations, integrating with AI assistants via the Model Control Protocol.-
- FlicenseNot gradedqualityDmaintenanceProvides 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.-
- AlicenseNot gradedqualityDmaintenanceProvides weather forecasts and alerts for US locations via the National Weather Service API, enabling AI assistants to deliver real-time weather information.ISC