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