mcp-dawa

DAWA（デンマーク住所Web 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