PostalDataPI MCP Server

ทางการ

การค้นหารหัสไปรษณีย์ทั่วโลก การตรวจสอบความถูกต้อง และการค้นหาเมืองสำหรับกว่า 70 ประเทศ ตอบสนองภายใน 10 มิลลิวินาที

GitHub

เอกสาร

PostalDataPI MCP Server

License: MIT Python 3.10+ PyPI

เซิร์ฟเวอร์ MCP (Model Context Protocol) สำหรับ PostalDataPI — ให้เอเจนต์ AI สามารถค้นหา ตรวจสอบ และสืบค้นรหัสไปรษณีย์ใน 240+ ประเทศและดินแดน พร้อมด้วยเมตาดาต้าที่หลากหลาย: เขตเวลา, เขตการปกครอง, ระดับความสูง และพิกัด

เครื่องมือ

เครื่องมือคำอธิบาย
lookup_postal_codeรับข้อมูลเมือง, รัฐ/ภูมิภาค และตัวย่อสำหรับรหัสไปรษณีย์ (เช่น ZIP ของสหรัฐฯ, รหัสไปรษณีย์ของสหราชอาณาจักร, PLZ ของเยอรมนี ฯลฯ)
validate_postal_codeตรวจสอบว่ารหัสไปรษณีย์มีอยู่ในประเทศหรือไม่
search_by_cityค้นหารหัสไปรษณีย์ทั้งหมดสำหรับเมืองหนึ่งๆ
get_postal_code_metadataเมตาดาต้าเต็มรูปแบบ: พิกัด, ลำดับชั้นการปกครอง, เขตเวลา, ระดับความสูง และอื่นๆ

การตั้งค่า

1. รับ API Key

ลงทะเบียนที่ postaldatapi.com/register — มีคำถามฟรี 1,000 ครั้ง ไม่ต้องใช้บัตรเครดิต

2. ติดตั้ง

pip install postaldatapi-mcp

3. กำหนดค่าด้วย Claude Code

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

4. กำหนดค่าด้วย Claude Desktop

เพิ่มลงในการตั้งค่า Claude Desktop ของคุณ (~/Library/Application Support/Claude/claude_desktop_config.json บน macOS):

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

การใช้งาน

เมื่อกำหนดค่าแล้ว ให้ถาม Claude อย่างเป็นธรรมชาติ:

  • "รหัสไปรษณีย์ 90210 คือเมืองอะไร"
  • "ค้นหารหัสไปรษณีย์ของสหราชอาณาจักร SW1A"
  • "10115 เป็นรหัสไปรษณีย์ของเยอรมนีที่ถูกต้องหรือไม่"
  • "รหัสไปรษณีย์สำหรับ Beverly Hills, CA มีอะไรบ้าง"
  • "รับพิกัดสำหรับรหัสไปรษณีย์ 100-0001 ในญี่ปุ่น"

Claude จะใช้เครื่องมือ PostalDataPI เพื่อตอบคำถามโดยอัตโนมัติ

ประเทศที่รองรับ

240+ ประเทศและดินแดน รวมถึงสหรัฐอเมริกา, สหราชอาณาจักร, แคนาดา, เยอรมนี, ฝรั่งเศส, ญี่ปุ่น, ออสเตรเลีย, บราซิล, อินเดีย และอีกมากมาย ดูรายชื่อทั้งหมดได้ที่ postaldatapi.com/countries

เมตาดาต้าที่หลากหลาย

นอกเหนือจากการค้นหาพื้นฐาน เครื่องมือ get_postal_code_metadata จะส่งคืนข้อมูลสูงสุด 18 ฟิลด์ต่อรหัสไปรษณีย์ รวมถึง:

  • พิกัด (ละติจูด, ลองจิจูด)
  • เขตเวลา (เช่น America/Mexico_City, Europe/Berlin)
  • ลำดับชั้นการปกครอง (รัฐ/จังหวัด, เขต, เทศบาล)
  • ระดับความสูง (เมตรเหนือระดับน้ำทะเล)
  • ชื่อสถานที่ และข้อมูลประเทศ

ตัวอย่างการตอบกลับสำหรับ Mexico City 06000:

{
  "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
}

ลิงก์