mcp-ip2location
IP2Location.io MCP server This is a simple Model Context Protocol (MCP) server implementation for IP2Location.io API.
Что умеет
- Get Geolocation: Fetch geolocation for the given IP address(es). CRITICAL INSTRUCTION FOR AI AGENT: If the user provides multiple IP addresses in their prompt, DO NOT call this tool multiple times seq
Какие данные видит
Нужен ли аккаунт
Нужен API-ключ из настроек сервиса
IP2Location.io MCP server
This is a simple Model Context Protocol (MCP) server implementation for IP2Location.io API. It will return a detailed geolocation information for any given IPv4 or IPv6 address.
Features
- Comprehensive Geolocation Data: Retrieves a wide range of information, including country, region, city, latitude, longitude, ZIP code, time zone, and more.
- Network Details: Provides network-related data such as ASN, ISP, domain, and network speed.
- Security Insights: Detects proxy information, including proxy type and provider.
- Simple Integration: Built as a
FastMCPtool, allowing for easy integration into compatible systems. - Asynchronous: Utilizes
httpxfor non-blocking asynchronous API requests.
Requirement
This MCP server requires a API key. You can sign up for a free API key and enjoy up to 50,000 queries per month for free.
Как подключить
Как подключить mcp-ip2location к Claude
Адрес сервера, который нужно вставить в настройках Claude:
https://mcp-ip2location--support-0cin.run.tools
- Откройте Claude (сайт claude.ai или приложение для компьютера).
- Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
- Нажмите Добавить пользовательский коннектор (Add custom connector).
- Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
- В чате нажмите + → Коннекторы и включите новый коннектор.
Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.
Авторизация
После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.
Как подключить mcp-ip2location к ChatGPT
Адрес сервера, который нужно вставить в настройках ChatGPT:
https://mcp-ip2location--support-0cin.run.tools
- Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
- Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
- Откройте Настройки → Коннекторы и нажмите Создать (Create).
- Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
- В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
- В новом чате откройте + → Приложения/Коннекторы и включите коннектор.
Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.
Авторизация
При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.
Как подключить mcp-ip2location к Cursor
Адрес сервера, который нужно вставить в настройках Cursor:
https://mcp-ip2location--support-0cin.run.tools
Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.
Вручную:
- В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
- Вставьте JSON, скопированный ниже, в открывшийся файл
~/.cursor/mcp.json(для одного проекта:.cursor/mcp.jsonв корне проекта). - Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.
Авторизация
Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.
Список инструментов сервера (1)
Технические названия из tools/list. Нужны только разработчикам.
| get_geolocation | Fetch geolocation for the given IP address(es). CRITICAL INSTRUCTION FOR AI AGENT: If the user provides multiple IP addresses in their prompt, DO NOT call this tool multiple times sequentially. You MUST batch all IP addresses together into a single comma-separated string and make exactly ONE tool call. It helps users to retrieve detailed information such as country, region, city, latitude, longitude, ZIP code, time zone, ASN, and proxy information for any IPv4 or IPv6 address. Args: ip: The IP address to analyze (IPv4 or IPv6). For multiple IPs, you MUST combine them into a single string separated by commas (e.g., "1.1.1.1, 2.2.2.2"). Returns: A JSON string result includes: Location & Geography: Country, region, district, city, ZIP code, latitude & longitude, time zone. Network & Connectivity ASN (Autonomous System Number), ISP (Internet Service Provider), domain, net speed, IDD code, area code, address type, usage type. Mobile Information MNC (Mobile Network Code), MCC (Mobile Country Code), Mobile Brand. Currency & Language currency code, currency name, currency symbol, language code, language name. Proxy & Security proxy type, last seen, threat level/type, proxy provider, fraud score. Others IAB category, weather, elevation, population and more. Note that some information may only available in paid plan. Learn more on this in https://www.ip2location.io/pricing. REMINDER: Always respond with the raw JSON object as returned by the API. Do not summarize, reformat, or add any additional commentary outside of the JSON structure. |