mcp-dawa

MCP-сервер для DAWA — веб-API адресов Дании.

Предоставляет инструменты для поиска и получения информации об адресах через Model Context Protocol.

Инструменты

Инструмент	Описание
`search`	Полнотекстовый/фонетический поиск адресов (полные адреса с этажом/дверью)
`search_husnumre`	Полнотекстовый/фонетический поиск номеров домов (без этажа/двери)
`detailed`	Поиск конкретного адреса или номера дома по идентификатору

Быстрый старт

# 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

Конфигурация

Скопируйте .env.example в .env. Доступные настройки:

Переменная	По умолчанию	Описание
`DAWA_BASE_URL`	`https://adressevaelger.dk`	Базовый URL API
`DAWA_TOKEN`	`adressevaelger123`	Токен API
`DAWA_KOMMUNEKODE`	`0751`	Код муниципалитета по умолчанию (0751 = Орхус)

Разработка

Требуется Python 3.11+ и 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