IP2Location.io MCP Server

официальный

Интеграция с API IP2Location.io для получения геолокационной информации по IP-адресу.

Документация

IP2Location.io MCP-сервер

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

Возможности

Полные геолокационные данные: Получает широкий спектр информации, включая страну, регион, город, широту, долготу, почтовый индекс, часовой пояс и многое другое.
Сетевые детали: Предоставляет данные, связанные с сетью, такие как ASN, интернет-провайдер, домен и скорость сети.
Сведения о безопасности: Определяет информацию о прокси, включая тип прокси и провайдера.
Простая интеграция: Создан как инструмент FastMCP, что позволяет легко интегрировать его в совместимые системы.
Асинхронность: Использует httpx для неблокирующих асинхронных запросов к API.

Требования

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

Если вы используете облачный MCP-сервер, вам понадобятся только Claude Desktop и npx, так как сервер размещен удаленно. Если вы хотите запустить оригинальный MCP-сервер локально, в локальной настройке используется uv, который можно установить, следуя инструкции.

Настройка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Где находится (IP)?
Где расположен (IP)?
Каковы координаты (IP)?

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

The output of the IP 8.8.8.8

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

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

[!NOTE]
IP2Location.io Bulk IP Geolocation API требует платного тарифного плана для работы.

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

IP2LOCATION_API_KEY

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

Инструмент

get_geolocation

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

Аргументы

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

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

Местоположение и география: Страна, регион, район, город, почтовый индекс, широта и долгота, часовой пояс.
Сеть и подключение: ASN (номер автономной системы), интернет-провайдер, домен, скорость сети, международный код, код города, тип адреса, тип использования.
Мобильная информация: MNC (код мобильной сети), MCC (код мобильной страны), мобильный бренд.
Валюта и язык: Код валюты, название валюты, символ валюты, код языка, название языка.
Прокси и безопасность: Тип прокси, последнее обнаружение, уровень/тип угрозы, провайдер прокси, оценка мошенничества.
Прочее: Категория IAB, погода, высота над уровнем моря, население и многое другое.

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

Лицензия

См. файл LICENSE.