Hungarian Postcode Validator

io.github.UnbearableDevv1.0.1更新於 Oct 9, 2026

Hungarian postcode lookup + validation - 3,484 codes, sub-10ms lookups, bulk address endpoint.

已驗證Streamable HTTP可網頁執行Location & LifestyleData & Analytics

概覽

AI 產生的概覽

依據匈牙利郵政官方資料驗證匈牙利郵遞區號與地址，查詢城鎮、州及布達佩斯區。

功能
這個遠端 MCP 伺服器以 3,484 筆郵遞區號與城鎮對應資料（涵蓋 2,962 個郵遞區號、全部 19 個州及布達佩斯）回答匈牙利地址問題。工具包括：lookup_postcode 傳回城鎮、州及布達佩斯區；lookup_city 傳回某城市的全部郵遞區號，且不區分變音符號；validate_address 給出是／否判斷，並在不符時提供更正建議；budapest_district_lookup 將 I-XXIII 或 1-23 區號對應到郵遞區號範圍；list_postcodes_in_county 批次列出某州全部郵遞區號。回應為結構化 JSON，README 稱查詢在 10 毫秒內完成。
適用情境
當助理需要檢查或正規化匈牙利郵政地址時使用，例如在寫入資料庫前驗證郵遞區號與城市是否相符、把郵遞區號解析為城鎮與州，或列出布達佩斯某區或某州的郵遞區號。不適用於街道層級地址驗證或非匈牙利地址。
執行需求
遠端 streamable HTTP 端點，不需要本機套件或執行環境。需在 Authorization 標頭提供 Apify API 權杖，格式為 'Bearer '。需要能連線至 Apify 代管的端點。
安裝前請注意
Authorization 標頭攜帶 Apify API 權杖，屬於應保密的憑證。此服務依工具呼叫計費：多數工具每次 $0.001，list_postcodes_in_county 每次 $0.005，使用會產生費用。查詢會把郵遞區號或城市名稱傳送到第三方代管端點。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Hungarian Postcode Validator，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "hu-postcode-validator": {
      "type": "http",
      "url": "https://unbearable-dev--hu-postcode-validator.apify.actor/mcp"
    }
  }
}

README

Hungarian Postcode & Address Validator

MCP server that validates Hungarian postcodes and addresses. Powered by the official Magyar Posta catalog and KSH (Hungarian Central Statistics Office) settlement data. Pennies per call.

Built by Unbearable Labs. Pay-per-event pricing — only billed when a tool is actually called.

Available on

  • Apify Actor Store — primary, metered usage (PPE)
  • MCPize — pending submission
  • MCP.so — pending submission
  • PulseMCP — pending submission
  • Smithery — pending submission
  • Glama — pending submission

Newsletter: Unbearable TechTips Weekly · All Actors: github.com/UnbearableDev

What it does

Point any MCP-capable client (Claude Desktop, Cursor, n8n, Make, Zapier, custom agents) at this server and get fast, structured answers to Hungarian address questions:

  • Validate a (postcode, city) pair before storing it in your DB
  • Look up the settlement and county for any HU postcode
  • Find all postcodes that serve a given city (handy for Budapest: 23 districts, 100+ postcodes)
  • List every postcode in a Hungarian county
  • Map Budapest district numbers (1–23 or I–XXIII) to their postcode ranges

Tools

ToolPurposePrice
lookup_postcode(postcode)Settlement + county + (if BP) district for a 4-digit HU postcode$0.001
lookup_city(city)All postcodes for a city (diacritic-insensitive — gyor matches Győr)$0.001
validate_address(postcode, city)yes/no + corrected suggestion if mismatch$0.001
budapest_district_lookup(district)Budapest I-XXIII (or 1-23) → list of postcodes in that district$0.001
list_postcodes_in_county(county_name)Bulk listing — every postcode in a county$0.005

Example responses

lookup_postcode(1102)

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

validate_address(1102, "Szeged")

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

budapest_district_lookup(14) (or "XIV") returns all postcodes in District XIV.

Pricing

EventUSD per call
lookup-call (most tools)$0.001
bulk-call (list_postcodes_in_county)$0.005

Effectively a free utility for occasional use; meaningful at high call volumes.

Data sources

  • Magyar Posta official postal catalog (Iranyitoszam-Internet_uj.xlsx) — postcode → settlement mapping
  • KSH (Hungarian Central Statistical Office) settlement registry — county / district / KSH code per settlement, via the open tamas-ferenci/IrszHnk compilation

Coverage: 3,484 postcode-settlement entries spanning 2,962 unique postcodes (1011–9985), all 19 Hungarian counties + Budapest. Refreshed quarterly.

Connecting from Claude Desktop

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

What's NOT covered

  • Street-level address validation (no clean public data source post-2022 KEKKH restrictions)
  • Fuzzy / Levenshtein city-name matching (v1.1)
  • Non-Hungarian addresses (consider another MCP for those)

Source / contact

Issues and ideas: [email protected] or the GitHub org UnbearableDev.

來源：README.md，提交 f4fc9ec

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026