MCP-сервер IP2Location.io

Это простая реализация сервера протокола Model Context Protocol (MCP) для API IP2Location.io. Он возвращает подробную информацию о геолокации для любого заданного IPv4 или IPv6-адреса.

Возможности

• Комплексные данные о геолокации: Получение широкого спектра информации, включая страну, регион, город, широту, долготу, почтовый индекс, часовой пояс и многое другое.

• Сведения о сети: Предоставление данных, связанных с сетью, таких как ASN, ISP, домен и скорость сети.

• Анализ безопасности: Обнаружение информации о прокси, включая тип прокси и провайдера.

• Простая интеграция: Создан как инструмент FastMCP, что позволяет легко интегрировать его в совместимые системы.

• Асинхронность: Использует httpx для неблокирующих асинхронных API-запросов.

Требования

Этот MCP-сервер поддерживает запросы без API-ключа с ограничением в 1000 запросов в день. Вы также можете зарегистрироваться для получения бесплатного API-ключа и использовать до 50 000 запросов в месяц.

Для настройки также используется uv, который можно установить, следуя руководству.

Настройка

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

1. Скачайте репозиторий на свой локальный компьютер.

2. Настройте менеджер пакетов uv, вы можете снова обратиться к руководству для этого.

3. Убедитесь, что у вас установлен Claude Desktop. Если нет, скачайте его отсюда для пользователей Windows и MacOS или следуйте этому руководству для пользователей Linux.

4. Откройте claude_desktop_config.json в выбранном вами редакторе. Если у вас его еще нет, следуйте этому руководству, чтобы создать его.

5. Добавьте следующее в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ip2locationio/src",
        "run",
        "server.py"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

6. Не забудьте заменить путь /path/to/ip2locationio на ваш фактический путь к MCP-серверу IP2Location.io на локальном компьютере.

7. Чтобы получить API-ключ, просто войдите в свою панель управления и скопируйте его оттуда. Замените <YOUR API key HERE> выше на ваш фактический API-ключ.

8. Перезапустите Claude Desktop после сохранения изменений, и он должен появиться в меню Connectors.

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

Просто введите запрос об IP-адресе в чате Claude Desktop. Примеры запросов:

• Где находится (IP)?

• Каково местоположение (IP)?

• Каковы координаты (IP)?

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

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

Вы также можете использовать API массовой геолокации IP2Location.io для запроса нескольких IP-адресов. Просто введите все IP-адреса через пробел. Например, 8.8.8.8 8.8.6.6.

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

IP2LOCATION_API_KEY

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

Инструмент

get_geolocation

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

Аргументы

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

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

• Местоположение и география: Страна, регион, район, город, почтовый индекс, широта и долгота, часовой пояс.

• Сеть и подключение: ASN (номер автономной системы), ISP (интернет-провайдер), домен, скорость сети, IDD-код, код зоны, тип адреса, тип использования.

• Мобильная информация: MNC (код мобильной сети), MCC (мобильный код страны), бренд мобильной связи.

• Валюта и язык: код валюты, название валюты, символ валюты, код языка, название языка.

• Прокси и безопасность: тип прокси, время последнего обнаружения, уровень/тип угрозы, провайдер прокси, оценка мошенничества.

• Прочее: категория IAB, погода, высота над уровнем моря, население и многое другое.

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

Лицензия

См. файл LICENSE.