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