mcp-dawa

MCP-Server für DAWA — Danmarks Adressers Web API.

Bietet Werkzeuge zur Adresssuche und -abfrage über das Model Context Protocol.

Werkzeuge

Werkzeug	Beschreibung
`search`	Freitext-/phonetische Adresssuche (vollständige Adressen mit Etage/Tür)
`search_husnumre`	Freitext-/phonetische Hausnummernsuche (ohne Etage/Tür)
`detailed`	ID-basierte Abfrage einer spezifischen Adresse oder Hausnummer

Schnellstart

# Clone and install
git clone https://github.com/itk-dev/mcp-dawa.git
cd mcp-dawa
uv sync --extra dev

# Run tests
uv run pytest

# Run locally
python -m mcp_dawa

# Run with Docker
docker compose --profile dev up --build

Konfiguration

Kopieren Sie .env.example nach .env. Verfügbare Einstellungen:

Variable	Standard	Beschreibung
`DAWA_BASE_URL`	`https://adressevaelger.dk`	API-Basis-URL
`DAWA_TOKEN`	`adressevaelger123`	API-Token
`DAWA_KOMMUNEKODE`	`0751`	Standard-Gemeindecode (0751 = Aarhus Kommune)

Entwicklung

Erfordert Python 3.11+ und uv.

# Install with dev dependencies
uv sync --extra dev

# Run tests
uv run pytest

# Docker dev (source mounted for live reload)
docker compose --profile dev up --build