loading…
Browse all
Dawa
FreeMCP server for the Danish Address Web API (DAWA), enabling free-text address search, house number search, and detailed address lookup by ID.
About
MCP server for the Danish Address Web API (DAWA), enabling free-text address search, house number search, and detailed address lookup by ID.
README
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
How to install
Add this to claude_desktop_config.json and restart Claude Desktop.
{
"mcpServers": {
"mcp-dawa": {
"command": "npx",
"args": []
}
}
}
