MCP-сервер PostalDataPI

Name: PostalDataPI MCP Server
Author: PostalDataPI

License: MIT Python 3.10+ PyPI

MCP-сервер (Model Context Protocol) для PostalDataPI — позволяет ИИ-агентам искать, проверять и находить почтовые индексы в более чем 240 странах с расширенными метаданными: часовой пояс, административные регионы, высота над уровнем моря и координаты.

Инструменты

Инструмент	Описание
`lookup_postal_code`	Получение города, штата/региона и сокращения для почтового индекса (ZIP в США, почтовый индекс в Великобритании, PLZ в Германии и т. д.)
`validate_postal_code`	Проверка существования почтового индекса в стране
`search_by_city`	Поиск всех почтовых индексов для города
`get_postal_code_metadata`	Полные метаданные: координаты, административная иерархия, часовой пояс, высота над уровнем моря и многое другое

Настройка

1. Получите API-ключ

Зарегистрируйтесь на postaldatapi.com/register — 1000 бесплатных запросов, кредитная карта не требуется.

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 действительным почтовым индексом Германии?"
"Какие почтовые индексы у Беверли-Хиллз, Калифорния?"
"Получи координаты для почтового индекса 100-0001 в Японии"

Claude автоматически использует инструменты PostalDataPI для ответа.

Поддерживаемые страны

Более 240 стран и территорий, включая США, Великобританию, Канаду, Германию, Францию, Японию, Австралию, Бразилию, Индию и многие другие. Полный список см. на postaldatapi.com/countries.

Расширенные метаданные

Помимо базового поиска, инструмент get_postal_code_metadata возвращает до 18 полей для каждого почтового индекса, включая:

Координаты (широта, долгота)
Часовой пояс (например, America/Mexico_City, Europe/Berlin)
Административная иерархия (штат/провинция, округ, муниципалитет)
Высота над уровнем моря (метры)
Название места и информация о стране

Пример ответа для Мехико 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
}