# mcp-dawa

MCP server for [DAWA](https://dawadocs.dataforsyningen.dk/) — Danmarks Adressers Web API.

Provides address search and lookup tools via the [Model Context Protocol](https://modelcontextprotocol.io/).

## 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

```bash
# 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](https://github.com/astral-sh/uv).

```bash
# 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
```