mcp-dawa

DAWA — 덴마크 주소 웹 API를 위한 MCP 서버입니다.

Model Context Protocol을 통해 주소 검색 및 조회 도구를 제공합니다.

도구

도구	설명
`search`	자유 텍스트/음성 주소 검색 (층/호수를 포함한 전체 주소)
`search_husnumre`	자유 텍스트/음성 건물 번호 검색 (층/호수 제외)
`detailed`	특정 주소나 건물 번호의 ID 기반 조회

빠른 시작

# 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`	API 기본 URL
`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