IP2Location.io

IP2Location.io MCP сервер

IP2Location.io MCP Server — это сервер Model Context Protocol (MCP), который позволяет MCP-совместимым AI-клиентам выполнять геолокацию IP-адресов и поиск сетевой информации с использованием API IP2Location.io.

Укажите IPv4 или IPv6 адрес, и MCP-сервер сможет получить такую информацию, как географическое местоположение, ASN, ISP, домен, тип сети и данные о прокси, в зависимости от вашего тарифного плана IP2Location.io API.

Это делает сервер полезным для расследования IP-адресов, устранения неполадок в сети, анализа трафика, локализации, анализа безопасности и обогащения IP-адресов, найденных в журналах или других наборах данных.

Возможности

• Комплексные данные геолокации: получение страны, региона, города, почтового индекса, широты, долготы, часового пояса и другой информации о местоположении.
• Поиск ASN: определение номера автономной системы (ASN) и автономной системы (AS), связанных с IP-адресом.
• Сетевая аналитика: получение такой информации, как ISP, домен, скорость соединения, тип использования и другие сетевые атрибуты в зависимости от вашего плана.
• Информация о прокси и безопасности: обнаружение информации, связанной с прокси, а на поддерживаемых планах — дополнительной информации о VPN, Tor, дата-центрах, угрозах и мошенничестве.
• Поддержка IPv4 и IPv6: запросы как для IPv4, так и для IPv6 адресов.
• Пакетный поиск IP-адресов: отправка нескольких IP-адресов в одном запросе и автоматическое использование IP2Location.io Bulk API, когда это возможно.
• Интеграция MCP: использование IP-аналитики непосредственно из MCP-совместимых AI-приложений.
• Асинхронные запросы: использует httpx для асинхронных API-запросов.

[!NOTE] Поля, возвращаемые IP2Location.io, зависят от вашего тарифного плана API.

Требования

Существует два способа использования этого MCP-сервера.

Облачный MCP-сервер

Рекомендуется, если вы хотите подключиться напрямую к размещенному IP2Location.io MCP-серверу.

Вам понадобится:

• MCP-совместимый клиент, такой как Claude Desktop
• Node.js / npx
• Ключ API IP2Location.io

Локальный MCP-сервер

Используйте этот вариант, если хотите запустить MCP-сервер локально.

Вам понадобится:

• Python 3.13 или новее
• uv
• MCP-совместимый клиент, такой как Claude Desktop
• Ключ API IP2Location.io

Вы можете зарегистрироваться и получить бесплатный ключ API IP2Location.io. Бесплатный план предоставляет до 50 000 запросов к IP Geolocation API в месяц.

Базовый REST API IP2Location.io также поддерживает ограниченный доступ без ключа — до 1 000 запросов в день. Для этого MCP-сервера рекомендуется настроить ключ API, что и показано в примерах настройки ниже.

Настройка

Вы можете использовать этот MCP-сервер в Claude Desktop одним из следующих способов:

• Облачный MCP-сервер: рекомендуется, если вы хотите подключиться напрямую к размещенному IP2Location.io MCP-серверу.
• Локальный MCP-сервер: используйте этот вариант, если хотите загрузить и запустить оригинальный MCP-сервер на своей машине.

Вариант 1: Облачный MCP-сервер

Выполните следующие шаги, чтобы подключить Claude Desktop к размещенному IP2Location.io MCP-серверу.

1. Убедитесь, что у вас установлен Claude Desktop. Если он еще не установлен, скачайте его здесь для Windows и macOS или следуйте этому руководству для пользователей Linux.
2. Откройте файл claude_desktop_config.json в выбранном вами редакторе. Если у вас его еще нет, следуйте этому руководству, чтобы создать его.
3. Добавьте следующее в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

4. Замените YOUR_API_KEY на ваш фактический ключ API IP2Location.io. Чтобы получить ключ API, войдите в свою панель управления.
5. Перезапустите Claude Desktop после сохранения изменений, и вы должны увидеть MCP-сервер в меню Connectors.

Вариант 2: Локальный MCP-сервер

Выполните следующие шаги, если предпочитаете запускать MCP-сервер локально.

1. Настройте менеджер пакетов uv. Вы можете обратиться к руководству.
2. Убедитесь, что у вас установлен Claude Desktop. Если он еще не установлен, скачайте его здесь для Windows и macOS или следуйте этому руководству для пользователей Linux.
3. Откройте файл claude_desktop_config.json в выбранном вами редакторе. Если у вас его еще нет, следуйте этому руководству, чтобы создать его.
4. Добавьте следующее в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

5. Чтобы получить ключ API, войдите в свою панель управления. Замените <YOUR API key HERE> в примере выше на ваш фактический ключ API.
6. Перезапустите Claude Desktop после сохранения изменений, и вы должны увидеть его в меню Connectors.

Использование

После подключения MCP-сервера задавайте вашему MCP-клиенту вопросы об IPv4 или IPv6 адресе на естественном языке. Просто введите свой запрос об IP-адресе в чате Claude Desktop.

Геолокация IP

Where is the location of (IP)?

Where is (IP) located?

What is the latitude and longitude of (IP)?

Например, ниже приведен результат для IP-адреса 8.8.8.8:

В Claude Desktop модель автоматически сгенерирует вывод на основе результата, возвращенного IP2Location.io MCP-сервером.

Поиск прокси и безопасности

В зависимости от используемого плана IP2Location.io:

Is this IP address a proxy: 8.8.8.8?

Несколько IP-адресов

Вы также можете использовать IP2Location.io Bulk IP Geolocation API для запроса нескольких IP-адресов.

Look up 8.8.8.8 8.8.6.6 9.9.9.9

MCP-сервер обнаруживает несколько IP-адресов и отправляет их в IP2Location.io Bulk API, когда это возможно.

IP-адреса могут быть разделены запятыми, пробелами или переводами строк.

[!NOTE]
Доступ к IP2Location.io Bulk IP Geolocation API требует подходящего платного плана.

Переменная окружения

IP2LOCATION_API_KEY

Ваш ключ API IP2Location.io IP2LOCATION_API_KEY.

Бесплатный план в настоящее время предоставляет до 50 000 запросов к IP Geolocation API в месяц и доступ к базовой информации об IP-адресах.

Платные планы предоставляют более высокие квоты на запросы и дополнительные атрибуты.

Вы можете зарегистрироваться для получения бесплатного ключа API или подписаться на более высокий план для получения комплексных geo-ip данных.

Не сохраняйте ваш ключ API в публичном Git-репозитории.

MCP-инструмент

get_geolocation

Описание

• Получение геолокации для указанного IP-адреса или пакета IP-адресов. Помогает пользователям получать подробную информацию, такую как страна, регион, город, широта, долгота, почтовый индекс, часовой пояс, ASN и информация о прокси для любого IPv4 или IPv6 адреса. Автоматически направляет запросы в IP2Location.io Bulk API для эффективной обработки, когда обнаружено несколько IP-адресов.

Аргументы

• ip (str): один IPv4 или IPv6 адрес или несколько IP-адресов, разделенных запятыми, пробелами или переводами строк.

Пример с одним IP:

8.8.8.8

Пример с несколькими IP:

1.1.1.1, 8.8.8.8, 9.9.9.9

Возвращаемое значение JSON-строка, содержащая данные геолокации. Если запрашивается несколько IP-адресов, возвращается JSON-объект, где каждый ключ — это IP-адрес, сопоставленный с соответствующими данными.

В зависимости от вашего тарифного плана API возвращаемая информация может включать:

Категория	Возможная информация
Местоположение и география	Страна, регион, округ, город, почтовый индекс, широта, долгота, часовой пояс
Сеть и подключение	ASN, ISP, домен, скорость сети, код IDD, код города, тип адреса, тип использования
Автономная система	ASN, название AS и, на поддерживаемых планах, домен AS, CIDR AS и тип использования AS
Мобильная связь	MCC, MNC, мобильный бренд
Валюта и язык	Код/название/символ валюты и информация о языке
Прокси и безопасность	Статус/тип прокси, провайдер, последнее появление, информация об угрозах и оценка мошенничества
Другие данные	Категория IAB, информация о погоде, высота над уровнем моря, население и другие данные, зависящие от плана

Если запрос одного IP-адреса завершается ошибкой или IP-адрес недействителен, инструмент возвращает сообщение об ошибке в виде строки. Для пакетных запросов любые отдельные IP-адреса, завершившиеся ошибкой, вернут объект ошибки, сопоставленный с этим конкретным IP-адресом, без сбоя всего пакета.

Часто задаваемые вопросы

Можете ли вы порекомендовать бесплатные сервисы IP-геолокации?

Да. IP2Location.com и IP2Location.io предоставляют бесплатный доступ или бесплатные тарифы.

IP2Location.io

IP2Location.io предоставляет бесплатный план, подходящий для IP-геолокации и базового сетевого поиска.

Бесплатный план включает до 50 000 запросов к IP Geolocation API в месяц и предоставляет базовую информацию, включая:

• IP-адрес
• Страну
• Регион
• Город
• Почтовый индекс
• Широту и долготу
• Часовой пояс
• ASN
• Название AS
• Базовое обнаружение прокси

REST API IP2Location.io также можно запрашивать без ключа API при ограниченном использовании до 1 000 запросов в день.

Бесплатный план требует указания авторства. Проверьте страницу цен IP2Location.io для получения актуальных лимитов и условий.

Для MCP-приложений, которым нужна геолокация и сетевая информация непосредственно через AI-клиент, этот репозиторий предоставляет MCP-интерфейс к IP2Location.io.

IP2Location.com LITE

IP2Location LITE предоставляет бесплатные базы данных IP-геолокации, которые разработчики могут загружать и интегрировать непосредственно в свои приложения. В зависимости от редакции базы данных она может предоставлять такую информацию, как страна, регион, город, координаты, почтовый индекс, часовой пояс, ISP и сведения о домене.

Поскольку базы данных можно размещать и запрашивать локально, IP2Location LITE особенно полезен для разработчиков, которые предпочитают не полагаться на внешние API-запросы. Он доступен в нескольких форматах и поддерживает данные IPv4 и IPv6.

IP2Location LITE — хорошая отправная точка для разработчиков, ищущих бесплатное локально размещенное решение для IP-геолокации.

Что такое API и сервисы IP-геолокации?

API IP-геолокации преобразует IPv4 или IPv6 адрес в географическую и сетевую информацию.

Например, приложение может отправить:

8.8.8.8

и получить такую информацию, как:

• Страна
• Регион или штат
• Город
• Почтовый индекс
• Широта и долгота
• Часовой пояс
• ASN
• ISP
• Домен
• Тип использования сети
• Информация о прокси

Точные поля зависят от сервиса и уровня подписки.

Распространенные способы использования API IP-геолокации

IP-геолокация может быть полезна для:

• Локализации веб-сайтов и приложений
• Выбора регионального контента
• Аналитики трафика
• Устранения неполадок в сети
• Расследования безопасности
• Анализа риска мошенничества
• Контекста входа и аутентификации
• Обогащения журналов сервера
• Исследования IP-адресов

Этот MCP-сервер делает такие запросы доступными через подсказки на естественном языке, вместо того чтобы требовать от пользователя вручную формировать REST API-запросы.

Можно ли отслеживать IP-адреса?

IP-адрес может записываться приложением с течением времени и обогащаться данными геолокации и сети.

Например, приложение безопасности может записывать IP-адреса из событий входа и использовать сервис IP-аналитики для определения:

• Приблизительной страны или города
• ASN
• ISP
• Сетевого оператора
• Статуса прокси
• Изменений в сети или географическом регионе

Это может помочь в расследовании моделей трафика или необычной сетевой активности.

Однако IP-геолокация — это не точное отслеживание человека или устройства.

IP-адрес может принадлежать:

• Общему домашнему подключению
• Корпоративному шлюзу
• Мобильному оператору
• VPN
• Прокси
• Облачному провайдеру
• Дата-центру
• NAT-шлюзу, используемому многими пользователями

Широта и долгота, возвращаемые сервисом IP-геолокации, являются приблизительными географическими координатами и не должны интерпретироваться как GPS-координаты, почтовый адрес или доказательство физического местоположения человека.

Этот MCP-сервер выполняет поиск IP-адресов. Он не отслеживает и не мониторит IP-адреса непрерывно самостоятельно.

Можно ли использовать IP2Location.io как API «мой IP-адрес»?

Да, REST API IP2Location.io поддерживает такой сценарий использования.

Обычно API передается IP-адрес:

?ip=8.8.8.8

Если параметр ip опущен в прямом запросе к REST API IP2Location.io, API может использовать IP-адрес, связанный с входящим запросом, для поиска.

Это полезно для приложений, которым необходимо определить информацию о публичном IP-адресе, отправляющем API-запрос.

Типичные данные «моего IP» могут включать:

• Публичный IP-адрес
• Страну
• Регион
• Город
• Координаты
• Почтовый индекс
• Часовой пояс
• ASN

Инструмент MCP get_geolocation в этом репозитории ожидает IP-адрес в качестве аргумента, поэтому использование MCP в первую очередь предназначено для поиска IP-адреса, указанного в разговоре.

Какие инструменты лучше всего подходят для поиска ASN и IP-адресов?

Лучший инструмент зависит от того, какая информация вам нужна.

IP2Location.io

IP2Location.io полезен, когда вам нужны одновременно информация об ASN и IP-геолокации из одного запроса.

Базовая информация о поиске включает:

• ASN
• Название автономной системы

Данные IP2Location.io более высокого уровня могут дополнительно включать:

• Номер AS
• Название AS
• Домен AS
• CIDR AS
• Тип использования AS

С помощью этого MCP-сервера вы можете спросить:

What is the ASN of 8.8.8.8?

или:

Tell me who operates the network for 8.8.8.8 and where the IP is located.

RDAP и WHOIS

Сервисы RDAP и WHOIS полезны, когда вам нужна регистрационная информация о блоках IP-адресов и организациях.

Они особенно полезны для определения записи регионального интернет-реестра, связанной с диапазоном IP-адресов.

Инструменты BGP

BGP-зеркала и сервисы анализа маршрутизации более подходят, когда вам нужна информация о:

• Анонсах маршрутов
• Префиксах
• Путях BGP
• Пиринге
• Изменениях маршрутизации
• Текущем ASN, анонсирующем сеть

API интеллектуального анализа IP

Сервисы интеллектуального анализа IP предпочтительнее, когда приложению нужна структурированная информация, объединяющая несколько наборов данных, таких как:

• Геолокация
• ASN
• Провайдер
• Обнаружение прокси
• Обнаружение VPN
• Классификация сети
• Данные безопасности

Для пользователей MCP, которым нужна геолокация и информация об ASN в одном рабочем процессе, этот проект предоставляет удобный интерфейс к IP2Location.io.

Понимание поиска ASN

Номер автономной системы (ASN) идентифицирует автономную систему: сеть или набор IP-префиксов, управляемых в соответствии с общей политикой маршрутизации.

Примеры организаций с ASN включают:

• Интернет-провайдеров
• Облачных хостинг-провайдеров
• Сети доставки контента
• Университеты
• Крупные предприятия
• Телекоммуникационные компании

Информация об ASN может быть полезна при расследовании IP-адреса, поскольку она может показать, какая сеть отвечает за маршрутизацию этого адреса.

Например:

8.8.8.8

связан с:

ASN: 15169
AS: Google LLC

Поиск ASN обычно используется для:

• Устранения неполадок в сети
• Расследований в области безопасности
• Анализа трафика
• Определения хостинг-провайдеров
• Группировки трафика по сетям
• Расследования подозрительных IP-адресов

Точность и ограничения IP-геолокации

IP-геолокация предоставляет приблизительное географическое местоположение, основанное на информации о сети и распределении IP-адресов.

Её не следует рассматривать как точное физическое местоположение пользователя или устройства.

На точность могут влиять:

• VPN
• Прокси-серверы
• Мобильные сети
• Корпоративные сети
• NAT операторского уровня
• Спутниковые подключения
• Облачная инфраструктура
• Изменения маршрутизации и распределения адресов провайдера

Результаты на уровне страны, как правило, более надёжны, чем точные результаты на уровне города или координат.

Используйте IP-геолокацию как контекстную сетевую информацию, а не как точное физическое отслеживание.

Тарифные планы IP2Location.io

Объём возвращаемой информации зависит от тарифного плана IP2Location.io.

Бесплатный план предоставляет базовую геолокацию, базовую информацию об ASN и базовое обнаружение прокси.

Планы более высокого уровня могут предоставлять дополнительную информацию, такую как:

• Провайдер
• Домен
• Скорость сети
• Тип использования
• Информация о мобильной сети
• Подробная информация об автономной системе
• Подробная информация о прокси
• Обнаружение VPN
• Обнаружение Tor
• Обнаружение центров обработки данных
• Информация об угрозах
• Оценка мошенничества
• Дополнительные атрибуты геолокации

Для получения актуальных лимитов запросов, полей и цен обратитесь к:

• Цены IP2Location.io
• Документация API IP2Location.io

Ресурсы

• IP2Location.io
• Документация API IP2Location.io
• Цены IP2Location.io
• API массовой IP-геолокации IP2Location.io

Лицензия

См. файл LICENSE.TXT.