MCP-Server

InfraNode bringt einen offiziellen MCP-Server mit. Er stellt die offenen Stadtdaten als Werkzeuge bereit, die ein KI-Agent direkt aufrufen kann, ohne dass du HTTP-Aufrufe von Hand schreibst.

Hinweis

Der unten gezeigte Install-Befehl setzt ein lokales Repo voraus. Der Quellcode wird in Kürze veröffentlicht; bis dahin ist die MCP-Installation nur mit Repo-Zugang möglich.

Was ist MCP

Das Model Context Protocol (MCP) ist ein offener Standard, über den KI-Agenten externe Werkzeuge und Datenquellen einbinden. Ein MCP-Server meldet seine Tools beim Client an, der Agent ruft sie bei Bedarf mit typisierten Argumenten auf und bekommt strukturiertes JSON zurück. Für dich als Entwickler heißt das: Statt eine API-Integration zu bauen, registrierst du einen Server einmal, und dein Agent kann die Daten unmittelbar nutzen. Der InfraNode-Server spricht stdio und läuft als lokaler Subprozess deines Clients, er öffnet keinen eigenen Netzwerk-Port.

Einrichtung in Claude Code

Registriere den Server mit einem Befehl. Claude Code startet ihn bei Bedarf als lokalen Subprozess.

claude mcp add infranode -- uv run --group mcp python -m infranode.mcp

{
  "mcpServers": {
    "infranode": {
      "command": "uv",
      "args": ["run", "--group", "mcp", "python", "-m", "infranode.mcp"]
    }
  }
}

{
  "mcpServers": {
    "infranode": {
      "command": "uv",
      "args": ["run", "--group", "mcp", "python", "-m", "infranode.mcp"],
      "env": {
        "INFRANODE_MCP_API_BASE": "https://infranode.dev/api/v1"
      }
    }
  }
}

Nach dem Hinzufügen stehen die InfraNode-Tools im Agenten zur Verfügung.

Einrichtung in Claude Desktop

Trage den Server in claude_desktop_config.json unter dem Schlüssel mcpServers ein (zweiter Tab oben). Die Datei liegt unter:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Optional setzt du die Base-URL pro Eintrag über die Umgebungsvariable INFRANODE_MCP_API_BASE (dritter Tab). Starte Claude Desktop nach dem Speichern neu, damit der Server geladen wird.

Wogegen der Server läuft

Der MCP-Server ist ein dünner Wrapper um die InfraNode-Live-API. Jedes Tool ruft die öffentliche REST-API auf und reicht deren normalisiertes JSON unverändert weiter. Standardmäßig spricht der Server die öffentliche API unter https://infranode.dev/api/v1 an. Es gibt keine eigene Mapping-Logik im Server und keinen API-Schlüssel für den lesenden Zugriff.

Tool-Übersicht

Der Server registriert je Stadtdaten-Ressource ein Tool, insgesamt 21. Jedes Tool erwartet einen Stadt-Slug (zum Beispiel berlin oder hamburg); pois nimmt zusätzlich einen optionalen Parameter type.

Stammdaten und Geo

Tool	Beschreibung
`get_city`	Stammdaten einer Stadt
`geo`	Geodaten
`demographics`	Demografie

Umwelt und Wetter

Tool	Beschreibung
`air_quality`	Luftqualität
`air_quality_live`	Luftqualität, Live-Messwerte
`weather`	Wetter
`pollen_uv`	Pollen- und UV-Index

Mobilität und Verkehr

Tool	Beschreibung
`traffic`	Verkehrslage
`transit`	ÖPNV
`charging`	Ladesäulen
`road_events`	Straßen- und Baustellenmeldungen

Wasser und Lage

Tool	Beschreibung
`water_level`	Pegelstände
`flood`	Hochwasserlage

Gesundheit und Energie

Tool	Beschreibung
`health`	Gesundheitsdaten
`icu_live`	Intensivbetten, Live
`energy`	Energie

Stadtleben und Politik

Tool	Beschreibung
`pois`	Points of Interest (optional gefiltert nach type)
`events`	Veranstaltungen
`webcams`	Webcams
`election`	Wahlergebnisse
`holidays`	Feiertage

Beispiel-Aufruf

Ein Agent holt die Stammdaten für Berlin. Das Ergebnis ist das normalisierte JSON der Live-API, unverändert weitergereicht.

get_city(slug="berlin")