Amtsblick

Amtsblick

Amtsblick ist ein MCP-Server, der amtliche österreichische Daten über den Ort verknüpft. Ein KI-Assistent fragt nach einer Gemeinde und bekommt Wetter und Pegelstände dazu – jeweils mit Quellenvermerk, Stand und Einheiten.

Amtsblick ist ein privates Open-Source-Projekt und kein offizielles Angebot einer Behörde.

Phase 1 umfasst den gemeinsamen Kern (Ortsverzeichnis, Quellenvermerk, Cache, Kontingent), das Modul Wetter (GeoSphere Austria) und das Modul Wasser (eHYD-Pegel). Weitere Module folgen nach demselben Muster.

Haftungshinweis. Amtsblick ist kein amtlicher Dienst und kein Warndienst. Die Antworten geben

Daten Dritter wieder, können verspätet, unvollständig oder falsch sein und ersetzen weder amtliche

Unwetter- noch Hochwasserwarnungen. Maßgeblich sind die Warndienste von GeoSphere Austria und der

Länder. Die Software wird ohne Gewähr bereitgestellt (siehe LICENSE); wer sie betreibt,

ist für die Einhaltung der Nutzungsbedingungen der Quellen selbst verantwortlich.

Amtsblick ist ein privates Projekt. Statistik Austria, GeoSphere Austria, das BMLUK und die

Hydrographischen Dienste der Länder sind daran nicht beteiligt und billigen weder das Projekt noch

die Aufbereitung ihrer Daten.

Tools

ort ist ein Gemeindename (auch mit Tippfehler, „St." und „Sankt" sind gleichwertig), optional mit Zusatz "Name, Bundesland", eine fünfstellige GKZ oder eine Koordinate "Breite, Länge". Ist ein Name mehrdeutig, kommt statt Daten die Liste der Kandidaten zurück.

Jede Antwort ist ein kompaktes JSON-Objekt. Es beginnt mit einer Zeile zusammenfassung und endet mit quellen und hinweise. Jeder Eintrag in quellen enthält Quelle, Lizenz mit Link zum Lizenztext, den vorgeschriebenen Vermerk, Link, Datensatz, gegebenenfalls DOI, Stand und eine Angabe, wie Amtsblick die Daten aufbereitet hat.

Einbinden

Es gibt vier Wege. Der gehostete Server läuft unter `https://amtsblick.aicodelabs.dev`; das Paket steht auf NuGet.org und in der MCP Registry als io.github.haraldrohan/amtsblick.

Kontaktadresse

Der User-Agent lautet Amtsblick/ (+ ; ). Die Kontaktadresse gehört dem Betreiber der jeweiligen Instanz und steht deshalb nicht im Repository. Wer Amtsblick lokal betreibt, setzt sie über die Umgebungsvariable Amtsblick__Kontakt. Ohne Kontaktadresse ruft das Modul Wasser nichts ab; Wetter und Ortssuche funktionieren auch ohne. Beim gehosteten Server ist sie vom Betreiber gesetzt.

claude.ai, Claude Desktop und Claude mobil: Connector per URL

Einstellungen → Connectors → eigenen Connector hinzufügen, als URL https://amtsblick.aicodelabs.dev/mcp. Eine Anmeldung ist nicht nötig.

Claude Desktop lokal: MCP Bundle

Die Datei amtsblick- - .mcpb aus dem GitHub-Release laden und doppelklicken. Claude Desktop fragt bei der Installation nach der Kontaktadresse. Ein installiertes .NET ist nicht nötig. Plattformen: win-x64, osx-arm64 (Apple Silicon), osx-x64 (Intel-Mac), linux-x64; je rund 45 MB.

Beim ersten Start lädt Amtsblick einmalig die Gemeindegrenzen der Statistik Austria (rund 90 MB Download, 60 MB auf der Platte, ein bis zwei Minuten). Bis dahin antworten die Tools mit dem Hinweis, dass die Gemeindedaten geladen werden. Sie liegen danach unter %LOCALAPPDATA%\Amtsblick bzw. ~/.local/share/Amtsblick.

Claude Code

# gehosteter Server

claude mcp add --transport http amtsblick https://amtsblick.aicodelabs.dev/mcp

lokal über NuGet

claude mcp add amtsblick --env Amtsblick__Kontakt=ihre.adresse@example.org -- dnx Amtsblick@0.1.3-beta --yes

VS Code und Visual Studio

In .vscode/mcp.json bzw. .mcp.json:

{

"servers": { "amtsblick": { "type": "stdio", "command": "dnx", "args": ["Amtsblick@0.1.3-beta", "--yes"], "env": { "Amtsblick__Kontakt": "ihre.adresse@example.org" } } } }

Für den gehosteten Server stattdessen { "type": "http", "url": "https://amtsblick.aicodelabs.dev/mcp" }. Die aktuelle Paketversion steht auf NuGet.org.

Aus dem Quelltext

Voraussetzung: .NET 10 SDK.

dotnet build -c Release

dotnet test

Der Server startet ohne Argument über stdio. Für Claude Code im Wurzelordner eine Datei .mcp.json anlegen (sie ist von Git ausgenommen, weil sie die Kontaktadresse enthält):

{

"mcpServers": { "amtsblick": { "type": "stdio", "command": "dotnet", "args": ["C:\Pfad\zu\Amtsblick\src\Amtsblick.Server\bin\Release\net10.0\Amtsblick.Server.dll"], "env": { "Amtsblick__Kontakt": "ihre.adresse@example.org" } } } }

Für Claude Desktop gehört derselbe Eintrag in die claude_desktop_config.json. Solange ein Client den Server geladen hat, ist die DLL gesperrt; vor einem neuen Build den Client schließen oder den Server aus einer Kopie starten (dotnet publish -o ).

Die Gemeinden lädt der Server beim ersten Start selbst. Von Hand geht es mit scripts/import-gemeinden.sh (Windows: scripts\import-gemeinden.ps1); im Repository landen sie unter data/.

Selbst hosten

# direkt

Amtsblick__Kontakt=betrieb@example.org dotnet run --project src/Amtsblick.Server -c Release -- --http

als Container

docker build -t amtsblick . docker run --rm -p 8080:8080 -e Amtsblick__Kontakt=betrieb@example.org amtsblick

Der MCP-Endpunkt ist /mcp (Streamable HTTP, zustandslos), der Zustand steht unter /health. Unter / liefert der Server eine kurze Startseite, unter /datenschutz die Datenschutzerklärung. Direkt gestartet lauscht der Server auf http://localhost:5210, im Container auf Port 8080.

• HTTPS stellt der Hosting-Anbieter oder ein vorgeschalteter Reverse Proxy bereit; der Server selbst spricht nur HTTP.
• Ohne Anmeldung: Der Server liest nur öffentliche Daten. Dafür gilt ein Rate-Limit je Client-IP (Http:AnfragenProMinute, Standard 60); darüber antwortet er mit 429.
• Origin-Prüfung: Browser-Anfragen werden nur von Http:ErlaubteUrspruenge (Standard https://claude.ai, https://claude.com) und von localhost angenommen, sonst 403. Anfragen ohne Origin-Header (Server zu Server) sind erlaubt.
• Hostnamen: AllowedHosts soll den öffentlichen Hostnamen nennen, nicht * (Schutz vor DNS-Rebinding). Hinter einem Proxy Http:HinterProxy einschalten, damit das Rate-Limit die Client-IP aus X-Forwarded-For nimmt.
• Logs: nur Methode, Pfad, Statuscode und Dauer. Keine IP-Adresse, keine Anfrageinhalte, keine Orte.
• Pegel vorladen: Im Container ist Module:Wasser:Vorladen eingeschaltet; der Bestand wird stündlich geholt, das Abrufmuster bleibt bei einem Abruf pro Stunde.
• Eigene Instanz: Wer Amtsblick selbst hostet, ist dafür der Betreiber. Http:Betreiber mit den eigenen Angaben setzen und DATENSCHUTZ.md vor dem Bauen durch die eigene Erklärung ersetzen; die Datei im Repository gilt für die Instanz des Projektinhabers.

Konfiguration

Abschnitt Amtsblick in src/Amtsblick.Server/appsettings.json; jede Einstellung lässt sich auch als Umgebungsvariable setzen (: wird zu __).

Ein beim Start abgeschaltetes Modul wird nicht registriert: seine Tools erscheinen nicht und es ruft nichts ab. Module:Wasser:Aktiv wirkt zusätzlich sofort: Wird der Wert in der appsettings.json neben der Programmdatei im laufenden Betrieb auf false gesetzt, unterbleibt jeder weitere Abruf von eHYD ohne Neustart.

Quellen und Lizenzvermerke

Eingebunden sind ausschließlich die folgenden freigegebenen Quellen. Alle stehen unter CC BY 4.0 und sind damit auch kommerziell frei nutzbar, sofern die Namensnennung erfolgt. Die Daten bleiben unter der Lizenz der Quelle (siehe NOTICE); der Code steht unter MIT.

Die Pflichten aus CC BY 4.0 erfüllt jede Antwort zweifach: am Ende der Zusammenfassung steht der Vermerk mit Lizenz, Link zum Lizenztext und dem Zusatz, dass die Daten umgerechnet und zusammengefasst bzw. aufbereitet wurden; ausführlich steht es im Feld quellen: Namensnennung im verlangten Wortlaut, Lizenz mit Link zum Lizenztext, Link zur Quelle und die Angabe, was Amtsblick verändert hat:

• Statistik Austria: Gemeindemittelpunkte aus den Grenzen berechnet, Schreibweise der Bezirksnamen vereinheitlicht, Wien als Ganzes ergänzt.
• GeoSphere Austria: Einheiten umgerechnet; bei der Prognose zusätzlich Wind aus u/v berechnet und Werte zu Zeitblöcken und Tageswerten zusammengefasst.
• eHYD: Statuscode in Lage, Tendenz und Akt