Hungarian Postcode Validator

匈牙利邮政编码和地址验证器

用于验证匈牙利邮政编码和地址的 MCP 服务。数据来自 Magyar Posta 官方目录和 KSH（匈牙利中央统计局）定居点数据。每次调用仅需几分钱。

由 Unbearable Labs 构建。 按事件付费——仅在实际调用工具时计费。

---

可在以下平台使用

• Apify Actor Store — 首选，按量计费（PPE）
• MCPize — 待提交
• MCP.so — 待提交
• PulseMCP — 待提交
• Smithery — 待提交
• Glama — 待提交

新闻简报： Unbearable TechTips Weekly · 所有 Actor： github.com/UnbearableDev

功能

将任何支持 MCP 的客户端（Claude Desktop、Cursor、n8n、Make、Zapier、自定义 Agent）连接到此服务，即可快速获取关于匈牙利地址的结构化答复：

• 验证 (postcode, city) 地址组合，再将其存入数据库
• 查询 任意 HU 邮政编码对应的定居点和州
• 查找 某个城市的所有邮政编码（尤其适用于布达佩斯：23 个区，100 多个邮政编码）
• 列出 匈牙利某个州的所有邮政编码
• 映射 布达佩斯区号（1–23 或 I–XXIII）对应的邮政编码范围

工具

工具	用途	价格
lookup_postcode(postcode)	查询 4 位 HU 邮政编码对应的定居点、州，以及（若为 BP）区	$0.001
lookup_city(city)	查询某个城市的所有邮政编码（不区分变音符号——gyor 可匹配 Győr）	$0.001
validate_address(postcode, city)	返回是/否；若不匹配则提供更正建议	$0.001
budapest_district_lookup(district)	查询布达佩斯 I-XXIII 区（或 1-23 区）内的邮政编码列表	$0.001
list_postcodes_in_county(county_name)	批量列出某个州的所有邮政编码	$0.005

响应示例

lookup_postcode(1102)

{
  "postcode": 1102,
  "found": true,
  "matches": [
    {
      "postcode": 1102,
      "settlement": "Budapest",
      "settlement_part": "X. kerület",
      "county": "Budapest"
    }
  ],
  "budapest_district": "X."
}

validate_address(1102, "Szeged")

{
  "valid": false,
  "reason": "city_mismatch",
  "postcode": 1102,
  "city": "Szeged",
  "expected_settlements": ["Budapest"]
}

budapest_district_lookup(14)（或 "XIV"）会返回 XIV 区的所有邮政编码。

定价

事件	每次调用的 USD 价格
lookup-call（大多数工具）	$0.001
bulk-call（list_postcodes_in_county）	$0.005

偶尔使用时基本上是免费工具；大量调用时费用则较为可观。

数据来源

• Magyar Posta 官方邮政目录（Iranyitoszam-Internet_uj.xlsx）——邮政编码 → 定居点映射
• KSH（匈牙利中央统计局）定居点登记册——通过开源 tamas-ferenci/IrszHnk 汇编数据，提供每个定居点的州、区和 KSH 代码

覆盖范围：3,484 条邮政编码与定居点对应记录，涵盖 2,962 个不同的邮政编码（1011–9985）、匈牙利全部 19 个州及布达佩斯。每季度更新。

从 Claude Desktop 连接

{
  "mcpServers": {
    "hu-postcode": {
      "transport": "streamable-http",
      "url": "https://YOUR-ACTOR-URL.apify.actor/mcp"
    }
  }
}

不包含的功能

• 街道级地址验证（KEKKH 于 2022 年实施限制后，没有可靠的公开数据源）
• 城市名称模糊匹配 / Levenshtein 匹配（v1.1）
• 非匈牙利地址（请考虑使用其他 MCP）

源码 / 联系方式

问题和想法：[email protected] 或 GitHub 组织 UnbearableDev。