mcp-dawa

MCP server for DAWA — Danmarks Adressers Web API.

Provides address search and lookup tools via the Model Context Protocol.

Tools

Tool	Description
search	Free-text/phonetic address search (full addresses with floor/door)
search_husnumre	Free-text/phonetic house number search (without floor/door)
detailed	ID-based lookup of a specific address or house number

Quick start

# 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

Configuration

Copy .env.example to .env. Available settings:

Variable	Default	Description
DAWA_BASE_URL	https://adressevaelger.dk	API base URL
DAWA_TOKEN	adressevaelger123	API token
DAWA_KOMMUNEKODE	0751	Default municipality code (0751 = Aarhus Kommune)

Development

Requires Python 3.11+ and 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