IPinfo MCP-сервер: геолокация, ASN и WHOIS

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → IPinfo, установите его без ключа, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

IPinfo

Данные об IP-адресах от IPinfo: геолокация, ASN и владелец сети, обнаружение VPN, прокси, Tor и резидентных прокси, компания, мобильный оператор, abuse-контакты, размещённые домены, диапазоны IP и WHOIS, по одному адресу или до 1 000 в пакете. Только чтение; часть запросов работает без токена, бесплатный токен открывает неограниченный IPinfo Lite.

Настройка

Работает без токена, с токеном лучше: настройка занимает меньше 2 минут. Коннектор обращается к двум хостам IPinfo: к текущему API на https://api.ipinfo.io (Lite, lookup, places, batch) и к классическому API на https://ipinfo.io (всё остальное).

1. Выберите IPinfo в каталоге коннекторов и установите его. Без токена работают только ipinfo_get_my_ip, ipinfo_get_ip_details и ipinfo_get_ip_field, с небольшим дневным лимитом; остальные инструменты отвечают 400 или 403.
2. Рекомендуется: зарегистрируйтесь на https://ipinfo.io/signup. Бесплатный тариф даёт неограниченные запросы IPinfo Lite (страна, континент и ASN). Скопируйте access token с https://ipinfo.io/dashboard/token в IPINFO_TOKEN без префикса Bearer. Он передаётся как Authorization: Bearer <token>.
3. Проверьте подключение через ipinfo_get_my_ip, а с токеном ещё и через ipinfo_get_token_info: он покажет тариф, сделанные и оставшиеся запросы за день и месяц и в features продукты данных, доступные токену.

Какой инструмент для какого тарифа:

• Без токена: ipinfo_get_my_ip, ipinfo_get_ip_details, ipinfo_get_ip_field.
• Бесплатный токен: дополнительно ipinfo_lite_lookup, ipinfo_lite_me и ipinfo_batch_lite.
• Тарифы Core, Plus или Max: ipinfo_lookup (геоданные до уровня города, тип ASN, флаги приватности и мобильной сети) и ipinfo_batch; Plus и Max ещё и ipinfo_get_place.
• Business, enterprise или соответствующий отдельный API: ipinfo_get_privacy, ipinfo_get_residential_proxy (дополнение для резидентных прокси), ipinfo_get_company, ipinfo_get_carrier, ipinfo_get_abuse_contact, ipinfo_get_hosted_domains, ipinfo_get_asn, ipinfo_get_ip_ranges, ipinfo_whois_net, ipinfo_whois_org и ipinfo_whois_poc. Токен без нужного продукта получает 403.

Что он читает:

• Где находится IP и кто им управляет: ipinfo_lite_lookup с бесплатным токеном, ipinfo_lookup с платным, ipinfo_get_ip_details в классическом формате с hostname, городом, регионом, страной, координатами, почтовым индексом, часовым поясом и AS-организацией. ipinfo_get_ip_field возвращает одно значение текстом, например только страну или город.
• Много IP сразу: ipinfo_batch_lite (бесплатно) или ipinfo_batch (платно, можно смешивать IP, поля вроде 8.8.8.8/country, ASN вроде AS15169 и пути вроде resproxy/1.1.1.1), до 1 000 записей за вызов; более длинные списки ИИ делит на части.
• Проверки на мошенничество и безопасность: флаги VPN, прокси, Tor, relay и хостинга через ipinfo_get_privacy, выходы резидентных прокси-сетей через ipinfo_get_residential_proxy, куда жаловаться на злоупотребления через ipinfo_get_abuse_contact и домены, размещённые на IP (обратный IP), через ipinfo_get_hosted_domains.
• Сети и организации: автономные системы с префиксами, пирами, апстримами и даунстримами (ipinfo_get_asn), диапазоны IP компании по её домену (ipinfo_get_ip_ranges), компания за IP (ipinfo_get_company), мобильный оператор с MCC и MNC (ipinfo_get_carrier), публичное место, к которому относится IP, например отель или аэропорт (ipinfo_get_place), и записи WHOIS по сети, организации или контактному лицу.
• ipinfo_get_my_ip и ipinfo_lite_me сообщают публичный IP сервера AnythingMCP, а не ваш.

Только чтение: все инструменты только читают, поэтому при установке ничего не отключено. Пакетные инструменты отправляются как POST, но только читают.

Форматы данных: классический API возвращает loc как "latitude,longitude" и org как "AS15169 Google LLC"; текущий API разделяет их на geo.latitude, geo.longitude и as.asn, as.name. Страны указаны кодами ISO 3166-1 alpha-2 (US, DE), часовые пояса именами IANA (Europe/Berlin). Частные и зарезервированные адреса возвращаются с bogon: true и без местоположения. Местоположение является оценкой того, где находится сеть, а не человек; на Plus radius указывает точность в км. Ответы пакетных запросов являются объектом с входными значениями в качестве ключей.

Постраничный вывод: ipinfo_get_hosted_domains принимает page (с 0) и limit (по умолчанию 100, до 1 000). Инструменты WHOIS возвращают 50 записей на страницу и принимают page (с 0).

Лимиты и частые ошибки: Lite не ограничен; у платных тарифов есть месячная квота, по её исчерпании приходит 429. 400 с "Token not passed" или "API Access Token Required" означает, что инструменту нужен токен, 403 "Unknown token" неверный токен, 403 при действующем токене продукт, которого нет в вашем тарифе, 404 "Wrong ip" неправильно записанный IP-адрес.

Коннектор не определяет местонахождение людей, ничего не меняет в вашем аккаунте IPinfo и не скачивает базы данных IPinfo.

Предварительные требования: (обязательных нет; необязательно: IPINFO_TOKEN)

Локальная установка коннектора

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Откройте http://localhost:3000/connectors/store, выберите IPinfo и установите его. Вставьте IPINFO_TOKEN, если он есть, или оставьте поле пустым.

Доступные инструменты

Примеры запросов

• «Где находится IP 8.8.8.8 и к какой сети и организации он относится?»
• «Проверь эти 50 IP из нашего журнала входов и сгруппируй их по стране и ASN.»
• «Является ли 185.220.101.1 адресом VPN, прокси, Tor или хостинга?»
• «Кто abuse-контакт для 203.0.113.45 и какой диапазон сети он охватывает?»
• «Какой тариф у моего токена IPinfo и сколько запросов осталось в этом месяце?»

Следующие шаги

• Подключить к Claude
• Подключить к ChatGPT