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
1

PostalDataPI MCP ile neler yapabilirsiniz?

  • Posta kodu sorgulama — Belirli bir posta koduyla ilişkili şehir, eyalet ve bölgeyi lookup_postal_code kullanarak sorgulayın.
  • Posta kodu doğrulama — Belirli bir ülke için bir posta kodunun geçerli olup olmadığını validate_postal_code ile kontrol edin.
  • Bir şehir için tüm kodları bulma — Belirli bir şehre hizmet veren tüm posta kodlarını search_by_city aracılığıyla alın.
  • Tam konum meta verilerini edinme — Bir posta kodu için koordinatlar, saat dilimi, yükseklik ve yönetim hiyerarşisini get_postal_code_metadata ile talep edin.

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