mcpapp1 — Wetter-MCP-Server

Ein kleiner Server für das Model Context Protocol, der aktuelle US-Wetterwarnungen für MCP-Clients wie Claude Desktop, Claude Code und Cursor bereitstellt.

Die Daten stammen von der National Weather Service API, die kostenlos ist und keinen API-Schlüssel erfordert.

Was er bereitstellt

Related MCP server: Weather Alert & Forecast MCP Tool

Voraussetzungen

• Python 3.13+

• uv

Einrichtung

git clone https://github.com/eyosiasbisrat/mcpapp1.git
cd mcpapp1
uv sync

Ausführen

Führen Sie den Server direkt über stdio aus:

uv run server/weather.py

Oder über die MCP CLI:

uv run mcp run server/weather.py

Untersuchen Sie ihn interaktiv im MCP Inspector:

uv run mcp dev server/weather.py

Ein MCP-Server spricht JSON-RPC über stdin/stdout. Wenn man ihn von Hand ausführt, wartet er also nur still auf Eingaben. Das ist zu erwarten — normalerweise startet ein Client ihn für Sie.

Einen Client verbinden

Claude Code / Cursor

Beide Konfigurationen sind bereits eingecheckt und verwenden relative Pfade, sodass sie nach uv sync ohne Änderungen funktionieren:

• .mcp.json — Claude Code

• .cursor/mcp.json — Cursor

Laden Sie das Editor-Fenster neu und genehmigen Sie den Server, wenn Sie dazu aufgefordert werden.

Claude Desktop

uv run mcp install server/weather.py

Beenden Sie dann Claude Desktop vollständig — einschließlich des Tray-Symbols, da das Schließen des Fensters es weiterlaufen lässt — und öffnen Sie es erneut.

Wenn dabei Claude app not found ausgegeben wird, obwohl Claude Desktop definitiv installiert ist, siehe unten.

Fehlerbehebung

Claude app not found unter Windows

mcp install sucht die Konfiguration von Claude Desktop an einem festen Speicherort:

%APPDATA%\Claude

Wenn Claude Desktop als MSIX / Microsoft Store-Paket installiert wurde, werden seine Daten in den Paketcontainer umgeleitet, und dieses Verzeichnis existiert nie:

%LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude\claude_desktop_config.json

Es gibt zwei Möglichkeiten, das zu beheben.

Bearbeiten Sie die echte Konfiguration direkt — fügen Sie einen mcpServers-Eintrag zur claude_desktop_config.json unter dem oben genannten Paketpfad hinzu und lassen Sie alle vorhandenen Schlüssel unverändert.

Oder überbrücken Sie die Pfade einmalig mit einem Verzeichnis-Junction, wonach mcp install für jeden Server normal funktioniert:

cmd /c mklink /J "%APPDATA%\Claude" "%LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude"

Ersetzen Sie Claude_<id> durch den tatsächlichen Namen Ihres Paketordners. Zum Rückgängigmachen entfernt cmd /c rmdir "%APPDATA%\Claude" nur die Verknüpfung, nicht die Konfiguration.

Wenn Sie den Server unter Windows manuell registrieren, verwenden Sie den absoluten Pfad von uv (z. B. C:\Users\<you>\.local\bin\uv.exe). Paketierte Apps erben die PATH-Variable Ihrer Shell nicht zuverlässig, daher kann ein bloßes uv beim Start fehlschlagen.

Überprüfen, ob der Server tatsächlich geladen ist

Überprüfen Sie den übergeordneten Prozess, um zu bestätigen, dass der Client ihn gestartet hat:

Get-CimInstance Win32_Process -Filter "Name='uv.exe'" | ForEach-Object {
  $p = Get-CimInstance Win32_Process -Filter "ProcessId=$($_.ParentProcessId)"
  "$($_.ProcessId) <- $($p.Name)"
}

Ein uv.exe, dessen übergeordneter Prozess Claude.exe ist, bedeutet, dass der Server läuft. Beachten Sie, dass einige Claude Desktop-Builds keine serverspezifischen Protokolle in logs\ schreiben; ein leerer Protokollordner ist daher kein Beweis für einen Fehler.

Projektstruktur

server/weather.py     the MCP server: tool, resource, and NWS client
main.py               placeholder entrypoint
.mcp.json             Claude Code server config
.cursor/mcp.json      Cursor server config
pyproject.toml        dependencies (httpx, mcp[cli])

Hinweise

• get_alerts deckt nur US-Bundesstaaten ab, da der NWS eine US-Behörde ist.

• Anfragen enthalten einen User-Agent-Header, den die NWS API erfordert.

• Netzwerk- und HTTP-Fehler werden abgefangen und erscheinen als freundliche Meldung „unable to fetch“ anstatt eines Tracebacks.