PostalDataPI MCP Server

resmi

70'ten fazla ülke için küresel posta kodu sorgulama, doğrulama ve şehir arama. 10 ms'nin altında yanıt süreleri.

GitHub

Dokümantasyon

PostalDataPI MCP Sunucusu

License: MIT Python 3.10+ PyPI

PostalDataPI için MCP (Model Bağlam Protokolü) sunucusu — yapay zeka aracılarının 240'tan fazla ülke ve bölgede posta kodlarını sorgulamasına, doğrulamasına ve aramasına olanak tanır; zengin meta verilerle birlikte: saat dilimi, idari bölgeler, rakım ve koordinatlar.

Araçlar

AraçAçıklama
lookup_postal_codeBir posta kodu için şehir, eyalet/bölge ve kısaltmayı getirir (ABD ZIP, İngiltere posta kodu, Alman PLZ, vb.)
validate_postal_codeBir ülkede posta kodunun var olup olmadığını kontrol eder
search_by_cityBir şehir için tüm posta kodlarını bulur
get_postal_code_metadataTam meta veriler: koordinatlar, idari hiyerarşi, saat dilimi, rakım ve daha fazlası

Kurulum

1. API Anahtarı Edinin

postaldatapi.com/register adresinden kaydolun — 1.000 ücretsiz sorgu, kredi kartı gerekmez.

2. Yükleme

pip install postaldatapi-mcp

3. Claude Code ile Yapılandırma

claude mcp add --transport stdio postaldatapi -- \
  env POSTALDATAPI_KEY=your_api_key_here postaldatapi-mcp

4. Claude Desktop ile Yapılandırma

Claude Desktop yapılandırmanıza ekleyin (macOS'ta ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "postaldatapi": {
      "command": "postaldatapi-mcp",
      "env": {
        "POSTALDATAPI_KEY": "your_api_key_here"
      }
    }
  }
}

Kullanım

Yapılandırıldıktan sonra Claude'a doğal bir şekilde sorun:

  • "90210 posta kodu hangi şehirde?"
  • "İngiltere SW1A posta kodunu sorgula"
  • "10115 geçerli bir Alman posta kodu mu?"
  • "Beverly Hills, CA için posta kodları nelerdir?"
  • "Japonya'daki 100-0001 posta kodunun koordinatlarını getir"

Claude, yanıtlamak için PostalDataPI araçlarını otomatik olarak kullanacaktır.

Desteklenen Ülkeler

ABD, İngiltere, Kanada, Almanya, Fransa, Japonya, Avustralya, Brezilya, Hindistan ve çok daha fazlası dahil 240'tan fazla ülke ve bölge. Tam listeyi postaldatapi.com/countries adresinde görebilirsiniz.

Zengin Meta Veriler

Temel sorgulamaların ötesinde, get_postal_code_metadata aracı posta kodu başına 18'e kadar alan döndürür:

  • Koordinatlar (enlem, boylam)
  • Saat dilimi (örn., America/Mexico_City, Europe/Berlin)
  • İdari hiyerarşi (eyalet/il, ilçe, belediye)
  • Rakım (deniz seviyesinden metre cinsinden yükseklik)
  • Yer adı ve ülke bilgisi

Mexico City 06000 için örnek yanıt:

{
  "postalCode": "06000",
  "country": "MX",
  "placeName": "Centro",
  "latitude": 19.4364,
  "longitude": -99.1553,
  "timezone": "America/Mexico_City",
  "adminLevel1": "Ciudad de México",
  "adminLevel2": "Cuauhtémoc",
  "elevation": 2239
}

Bağlantılar