IP Geolocation MCP Server — это сервер Model Context Protocol (MCP), предоставляющий AI-агентам возможности геолокации IP-адресов через API ipinfo.io. Он позволяет определять местоположение устройств, выявлять VPN и прокси-трафик, а также визуализировать наборы IP-адресов на интерактивной карте для решения задач кибербезопасности и сетевой аналитики.
Ключевые особенности:
ipinfo_lookup_my_ip: Инструмент для автоматического определения и геолокации собственного IP-адреса агента без каких-либо входных параметров, что позволяет мгновенно получить контекст о текущем местоположении системы.
ipinfo_lookup_ips: Мощный инструмент массового поиска, способный обрабатывать до 500 000 IP-адресов за один вызов. Поддерживает два режима детализации: полный отчет и экономичный режим “summary”, который отсекает тяжелые вложенные блоки для сохранения токенов при пакетной обработке.
ipinfo_check_residential_proxy: Специализированный инструмент для проверки, является ли IP-адрес выходным узлом резидентного прокси. Требует корпоративного тарифа IPinfo с соответствующим аддоном.
ipinfo_generate_map_url: Функция для создания интерактивной карты на сайте ipinfo.io, визуализирующей геопозиции переданного списка IP-адресов, с автоматической фильтрацией некорректных адресов и отчетом о причине их исключения.
Умная обработка ошибок и кэширование: Все инструменты возвращают структурированные ошибки в JSON с машиночитаемыми кодами, флагом временности сбоя и подсказками по исправлению. Встроенный LRU-кэш с настраиваемыми TTL и размером снижает нагрузку на API и ускоряет повторные запросы.
Для кого: Инструмент ориентирован на специалистов по кибербезопасности, SOC-аналитиков, DevOps-инженеров и разработчиков AI-приложений, которым необходимо в режиме реального времени обогащать логи, проверять подозрительный трафик, анализировать источники атак или предоставлять геоконтекст в рамках работы AI-ассистентов. Особенно полезен при расследовании инцидентов и автоматизированном анализе сетевой инфраструктуры.
Сценарии использования:
Автоматическое расследование подозрительных попыток входа AI-агентом: агент получает IP из лога, проверяет его геолокацию, флаги VPN/Tor/хостинга и принимает решение о блокировке или дополнительной верификации пользователя.
Массовый анализ логов веб-сервера или файрвола с геопривязкой каждого входящего соединения для выявления аномальной географии трафика и построения карты угроз.
Интеграция в AI-ассистента для поддержки клиентов, который по IP-адресу обратившегося автоматически определяет его страну и город, чтобы предложить релевантные локальные услуги или определить язык ответа.
Создание визуальных отчетов для руководства путем генерации интерактивных карт, отображающих географию клиентов, источников атак или распределение корпоративной сети на основе списков IP.
Цены и доступность: Сам сервер является бесплатным проектом с открытым исходным кодом (лицензия MIT). Для его работы используется API сервиса IPinfo, который предоставляет бесплатный тариф Lite с базовой информацией о стране и ASN без токена. Для доступа к полным данным геолокации, флагам конфиденциальности, данным о провайдере и другим расширенным полям требуется платная подписка IPinfo уровней Core, Plus или Enterprise. Тарифы IPinfo стартуют с бесплатного уровня, а платные планы оплачиваются ежемесячно в зависимости от объёма запросов.
