MCP-сервер IPGeolocation.io

Официальный MCP-сервер для IPGeolocation.io. Включает 16 инструментов MCP: геолокация IP, обнаружение угроз/VPN/прокси, поиск и конвертация часовых поясов, данные о восходе/закате/луне, сведения об ASN, контакты для жалоб и парсинг user-agent. Семь инструментов работают на бесплатном тарифе (1000 кредитов в день). Платные тарифы открывают доступ ко всем 16 инструментам, а также к пакетным эндпоинтам (до 1000 элементов за вызов).

Работает с Claude Desktop, Cursor, Windsurf, VS Code, Codex, Cline, Glama и любым другим MCP-клиентом.

Быстрый старт

1. Создайте бесплатный API-ключ IPGeolocation

2. Пользователи Cursor могут установить сервер в один клик:

   

3. Добавьте это в конфигурацию вашего MCP-клиента (см. Установка по клиентам ниже для поиска пути к файлу конфигурации):

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

4. Перезапустите клиент.

5. Проверьте работу: спросите "Где находится 8.8.8.8?"

Содержание

• Быстрый старт

• Установка по клиентам

• Проверка работы

• Инструменты по тарифам

• Справочник инструментов

• Примеры промптов

• Примеры ответов и вывода инструментов

• Коды ошибок

• Как это работает

• Кэширование

• Переменные окружения

• Сборка из исходного кода

• Docker

• Тестирование

• Устранение неполадок

• Цены

• Ссылки

• Лицензия

• Политика конфиденциальности

Установка по клиентам

Требования

• Node.js 18 или новее

• npx, доступный в терминале

• API-ключ IPGeolocation.io для большинства инструментов

get_my_ip работает без API-ключа. Все остальное требует его наличия.

Зарегистрируйтесь для получения бесплатного API-ключа IPGeolocation

Codex CLI

codex mcp add ipgeolocation --env IPGEOLOCATION_API_KEY=<YOUR_API_KEY> -- npx -y ipgeolocation-io-mcp
codex mcp list

Запустите новую сессию Codex после добавления сервера.

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Перезапустите Claude Desktop после сохранения. Мы также предоставляем manifest.json для клиентов, поддерживающих MCP Bundles.

Cline

Откройте панель MCP Servers > Configure > Advanced MCP Settings. Добавьте в cline_mcp_settings.json:

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Перезапустите Cline после сохранения.

Cursor

Установка в один клик:

Или добавьте вручную в .cursor/mcp.json:

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Перезапустите Cursor после сохранения.

Windsurf

Добавьте в ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Перезапустите Windsurf после сохранения.

VS Code / GitHub Copilot

Добавьте в ваш settings.json для VS Code:

{
  "mcp": {
    "servers": {
      "ipgeolocation": {
        "command": "npx",
        "args": ["-y", "ipgeolocation-io-mcp"],
        "env": {
          "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
        }
      }
    }
  }
}

Перезапустите VS Code после сохранения.

Glama

Вы можете попробовать сервер напрямую на Glama. Требуется только IPGEOLOCATION_API_KEY. Оставьте другие поля переменных окружения пустыми, если не хотите изменять кэш, тайм-аут или лимиты вывода.

Если у вас еще нет ключа, создайте бесплатный API-ключ IPGeolocation.

Любой другой MCP-клиент

Используйте эту конфигурацию:

{
  "command": "npx",
  "args": ["-y", "ipgeolocation-io-mcp"],
  "env": {
    "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
  }
}

Проверка работы

Попробуйте это после настройки:

Инструменты по тарифам

Бесплатный тариф

1000 кредитов в день. Доступны эти 7 инструментов:

Платные тарифы

Все 16 инструментов. Платные тарифы также добавляют поля network, company и расширенные поля asn в lookup_ip, плюс параметр include для security, abuse, hostname, liveHostname, hostnameFallbackLive, user_agent, geo_accuracy, dma_code или *.

Расчет кредитов для lookup_ip с include:

Для получения актуальной информации о тарифах см. страницу цен IPGeolocation.

Справочник инструментов

lookup_ip

Поиск по одному IP или домену. Бесплатно и платно. 1 кредит.

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

Бесплатный тариф возвращает базовое местоположение, метаданные страны, валюту, часовой пояс и базовый ASN. Платные тарифы добавляют network, company, расширенный ASN и параметр include. Обратите внимание, что поиск по доменам требует платного тарифа.

Совет: комбинирование include с fields может снизить стоимость в кредитах. Например, include=security&fields=security стоит 2 кредита вместо 3, так как вы пропускаете базовый ответ геолокации. Аналогично, include=abuse&fields=abuse стоит 1 кредит вместо 2.

bulk_lookup_ip

Пакетный поиск IP. Платно. 1 кредит за IP.

Принимает массив IP или доменов (до 1000 по умолчанию, настраивается через IPGEOLOCATION_MCP_MAX_BULK_ITEMS). Поддерживает те же опции include, fields и excludes, что и lookup_ip.

get_my_ip

Возвращает публичный IP машины, на которой запущен сервер. Бесплатно. 0 кредитов. API-ключ не нужен.

Не принимает параметров. Всегда обращается к сети (не кэшируется). Полезно для быстрой проверки работоспособности процесса сервера.

check_security

Данные об угрозах и анонимности для одного IP. Платно. 2 кредита.

Возвращает рейтинг угрозы, флаги VPN/прокси/Tor, имена провайдеров, показатели уверенности, индикаторы ботов/спама, флаги анонимности и статус облачного провайдера.

Если в том же промпте запрашиваются местоположение, ASN или данные для жалоб, лучше использовать lookup_ip с include=security, так как это объединяет все в одном вызове (всего 3 кредита вместо 2 + 1 отдельно).

| Параметр | Обязате