IP2Location.io

공식

IP2Location.io API 통합을 통해 IP 주소의 지리적 위치 정보를 검색합니다.

GitHub
17
이 MCP 사용해 보기스폰서

IP2Location Io MCP(으)로 무엇을 할 수 있나요?

  • 지리적 위치 조회 — get_geolocation을 통해 모든 IPv4 또는 IPv6 주소의 국가, 지역, 도시, 좌표, 우편번호 또는 시간대를 요청합니다.
  • ASN 및 네트워크 인텔리전스 — IP 주소와 연결된 자율 시스템 번호, ISP, 도메인 및 네트워크 사용 유형을 식별합니다.
  • 프록시 및 보안 검사 — IP 주소가 프록시인지 확인하고 지원되는 요금제에서 위협 또는 사기 정보를 검색합니다.
  • 대량 IP 강화 — 하나의 프롬프트에서 여러 IP를 쿼리하고(쉼표, 공백 또는 줄바꿈으로 구분) 각 주소에 대한 결과를 자동으로 가져옵니다.

문서

IP2Location.io MCP 서버

IP2Location.io MCP 서버는 MCP 호환 AI 클라이언트가 IP2Location.io API를 사용하여 IP 주소 지리적 위치 및 네트워크 인텔리전스 조회를 수행할 수 있게 해주는 Model Context Protocol(MCP) 서버입니다.

IPv4 또는 IPv6 주소를 제공하면 MCP 서버는 IP2Location.io API 요금제에 따라 지리적 위치, ASN, ISP, 도메인, 네트워크 유형, 프록시 정보 등의 정보를 검색할 수 있습니다.

이는 IP 조사, 네트워크 문제 해결, 트래픽 분석, 현지화, 보안 분석, 로그 또는 기타 데이터 세트에서 발견된 IP 주소 보강에 유용합니다.

mcp-ip2location-io MCP server

Trust Score

기능

  • 포괄적인 지리적 위치 데이터: 국가, 지역, 도시, 우편번호, 위도, 경도, 시간대 및 기타 위치 정보를 검색합니다.
  • ASN 조회: IP 주소와 연결된 자율 시스템 번호(ASN) 및 자율 시스템(AS)을 식별합니다.
  • 네트워크 인텔리전스: 요금제에 따라 ISP, 도메인, 연결 속도, 사용 유형 및 기타 네트워크 속성과 같은 정보를 검색합니다.
  • 프록시 및 보안 정보: 프록시 관련 정보를 감지하고, 지원되는 요금제에서는 추가 VPN, Tor, 데이터 센터, 위협 및 사기 정보를 제공합니다.
  • IPv4 및 IPv6 지원: IPv4 및 IPv6 주소를 모두 쿼리할 수 있습니다.
  • 대량 IP 조회: 하나의 프롬프트에서 여러 IP 주소를 보내고 가능한 경우 IP2Location.io Bulk API를 자동으로 사용합니다.
  • MCP 통합: MCP 호환 AI 애플리케이션에서 직접 IP 인텔리전스를 사용합니다.
  • 비동기 요청: 비동기 API 요청에 httpx을 사용합니다.

[!NOTE] IP2Location.io에서 반환되는 필드는 API 구독 요금제에 따라 다릅니다.

요구 사항

이 MCP 서버를 사용하는 방법은 두 가지가 있습니다.

클라우드 호스팅 MCP 서버

호스팅된 IP2Location.io MCP 서버에 직접 연결하려는 경우 권장됩니다.

필요한 항목:

  • Claude Desktop과 같은 MCP 호환 클라이언트
  • Node.js / npx
  • IP2Location.io API 키

로컬 MCP 서버

MCP 서버를 로컬에서 실행하려는 경우 이 옵션을 사용합니다.

필요한 항목:

  • Python 3.13 이상
  • uv
  • Claude Desktop과 같은 MCP 호환 클라이언트
  • IP2Location.io API 키

무료 IP2Location.io API 키에 가입할 수 있습니다. 무료 요금제는 월 최대 50,000회의 IP 지리적 위치 API 쿼리를 제공합니다.

기본 IP2Location.io REST API는 하루 최대 1,000회 쿼리의 제한적인 키 없는 액세스도 지원합니다. 이 MCP 서버의 경우 API 키 구성이 권장되며 아래 설정 예제에서 사용됩니다.

설정

Claude Desktop에서 이 MCP 서버를 다음 두 가지 방법 중 하나로 사용할 수 있습니다:

  • 클라우드 호스팅 MCP 서버: 호스팅된 IP2Location.io MCP 서버에 직접 연결하려는 경우 권장됩니다.
  • 로컬 MCP 서버: 원본 MCP 서버를 자신의 머신에 다운로드하여 실행하려는 경우 사용합니다.

옵션 1: 클라우드 호스팅 MCP 서버

Claude Desktop을 호스팅된 IP2Location.io MCP 서버에 연결하려면 다음 단계를 따르세요.

  1. Claude Desktop이 설치되어 있는지 확인하세요. 아직 설치하지 않은 경우 Windows 및 macOS용 여기에서 다운로드하거나 Linux 사용자는 이 가이드를 따르세요.
  2. 원하는 편집기에서 claude_desktop_config.json 파일을 엽니다. 아직 없는 경우 이 가이드를 따라 생성하세요.
  3. claude_desktop_config.json에 다음을 추가합니다:
{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}
  1. YOUR_API_KEY을 실제 IP2Location.io API 키로 교체하세요. API 키를 얻으려면 대시보드에 로그인하세요.
  2. 변경 사항을 저장한 후 Claude Desktop을 다시 시작하면 Connectors 메뉴에 MCP 서버가 나타나는 것을 확인할 수 있습니다.

옵션 2: 로컬 MCP 서버

MCP 서버를 로컬에서 실행하려는 경우 다음 단계를 따르세요.

  1. uv 패키지 관리자를 설정하세요. 가이드를 참조할 수 있습니다.
  2. Claude Desktop이 설치되어 있는지 확인하세요. 아직 설치하지 않은 경우 Windows 및 macOS용 여기에서 다운로드하거나 Linux 사용자는 이 가이드를 따르세요.
  3. 원하는 편집기에서 claude_desktop_config.json 파일을 엽니다. 아직 없는 경우 이 가이드를 따라 생성하세요.
  4. claude_desktop_config.json에 다음을 추가합니다:
{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}
  1. API 키를 얻으려면 대시보드에 로그인하세요. 위 예제의 <YOUR API key HERE>을 실제 API 키로 교체하세요.
  2. 변경 사항을 저장한 후 Claude Desktop을 다시 시작하면 Connectors 메뉴에 나타나는 것을 확인할 수 있습니다.

사용법

MCP 서버가 연결되면 MCP 클라이언트에게 자연어로 IPv4 또는 IPv6 주소에 대해 질문하세요. Claude Desktop의 채팅에 IP에 대한 쿼리를 입력하기만 하면 됩니다.

IP 지리적 위치

Where is the location of (IP)?

Where is (IP) located?

What is the latitude and longitude of (IP)?

예를 들어, 아래는 IP 8.8.8.8의 결과입니다:

The output of the IP 8.8.8.8

Claude Desktop에서 모델은 IP2Location.io MCP 서버가 반환한 결과를 기반으로 출력을 자동으로 생성합니다.

프록시 및 보안 조회

사용 중인 IP2Location.io 요금제에 따라:

Is this IP address a proxy: 8.8.8.8?

여러 IP 주소

여러 IP 주소를 쿼리하기 위해 IP2Location.io Bulk IP Geolocation API를 활용할 수도 있습니다.

Look up 8.8.8.8 8.8.6.6 9.9.9.9

MCP 서버는 여러 IP 주소를 감지하여 가능한 경우 IP2Location.io Bulk API로 보냅니다.

IP 주소는 쉼표, 공백 또는 줄바꿈으로 구분할 수 있습니다.

[!NOTE]
IP2Location.io Bulk IP Geolocation API 액세스에는 적격한 유료 요금제가 필요합니다.

환경 변수

IP2LOCATION_API_KEY

IP2Location.io API 키 IP2LOCATION_API_KEY.

무료 요금제는 현재 월 최대 50,000회의 IP 지리적 위치 API 쿼리와 기본 IP 정보 액세스를 제공합니다.

유료 요금제는 더 높은 쿼리 할당량과 추가 속성을 제공합니다.

무료 API 키는 가입하거나 포괄적인 지리적 IP 데이터를 위해 상위 요금제 구독할 수 있습니다.

API 키를 공개 Git 저장소에 커밋하지 마세요.

MCP 도구

get_geolocation

설명

  • 주어진 IP 주소 또는 IP 주소 배치에 대한 지리적 위치를 가져옵니다. 사용자가 모든 IPv4 또는 IPv6 주소에 대해 국가, 지역, 도시, 위도, 경도, 우편번호, 시간대, ASN 및 프록시 정보와 같은 세부 정보를 검색하는 데 도움이 됩니다. 여러 IP가 감지되면 효율적인 처리를 위해 요청을 IP2Location.io Bulk API로 자동 라우팅합니다.

인수

  • ip (str): 하나의 IPv4 또는 IPv6 주소, 또는 쉼표, 공백 또는 줄바꿈으로 구분된 여러 IP 주소.

단일 IP 예제:

8.8.8.8

여러 IP 예제:

1.1.1.1, 8.8.8.8, 9.9.9.9

반환 값 지리적 위치 데이터가 포함된 JSON 문자열입니다. 여러 IP를 쿼리하는 경우 각 키가 해당 데이터에 매핑된 IP 주소인 JSON 객체를 반환합니다.

API 요금제에 따라 반환되는 정보에는 다음이 포함될 수 있습니다:

카테고리가능한 정보
위치 및 지리국가, 지역, 구, 도시, 우편번호, 위도, 경도, 시간대
네트워크 및 연결ASN, ISP, 도메인, 네트워크 속도, IDD 코드, 지역 번호, 주소 유형, 사용 유형
자율 시스템ASN, AS 이름 및 지원되는 요금제에서는 AS 도메인, AS CIDR 및 AS 사용 유형
모바일MCC, MNC, 모바일 브랜드
통화 및 언어통화 코드/이름/기호 및 언어 정보
프록시 및 보안프록시 상태/유형, 공급자, 마지막 확인, 위협 정보 및 사기 점수
기타 데이터IAB 카테고리, 날씨 정보, 고도, 인구 및 기타 요금제 종속 데이터

단일 IP 요청이 실패하거나 IP가 유효하지 않은 경우 도구는 문자열로 오류 메시지를 반환합니다. 대량 요청의 경우 실패한 개별 IP는 전체 배치를 실패시키지 않고 해당 특정 IP 주소에 매핑된 오류 객체를 반환합니다.

일반적인 질문

무료 IP 지리적 위치 서비스를 추천할 수 있나요?

네. IP2Location.com 및 IP2Location.io는 무료 액세스 또는 무료 티어를 제공합니다.

IP2Location.io

IP2Location.io는 IP 지리적 위치 및 기본 네트워크 조회에 적합한 무료 요금제를 제공합니다.

무료 요금제에는 월 최대 50,000회의 IP 지리적 위치 API 쿼리가 포함되며 다음 기본 정보를 제공합니다:

  • IP 주소
  • 국가
  • 지역
  • 도시
  • 우편번호
  • 위도 및 경도
  • 시간대
  • ASN
  • AS 이름
  • 기본 프록시 감지

IP2Location.io REST API는 하루 최대 1,000회 요청의 제한적인 사용을 위해 API 키 없이도 쿼리할 수 있습니다.

무료 요금제에는 출처 표시가 필요합니다. 현재 한도 및 조건은 IP2Location.io 가격 페이지를 확인하세요.

AI 클라이언트를 통해 지리적 위치 및 네트워크 정보를 직접 필요로 하는 MCP 애플리케이션의 경우, 이 저장소는 IP2Location.io에 대한 MCP 인터페이스를 제공합니다.

IP2Location.com LITE

IP2Location LITE는 개발자가 다운로드하여 애플리케이션에 직접 통합할 수 있는 무료 IP 지리적 위치 데이터베이스를 제공합니다. 데이터베이스 에디션에 따라 국가, 지역, 도시, 좌표, 우편번호, 시간대, ISP 및 도메인 세부 정보와 같은 정보를 제공할 수 있습니다.

데이터베이스를 로컬에서 호스팅하고 쿼리할 수 있으므로 IP2Location LITE는 외부 API 요청에 의존하지 않으려는 개발자에게 특히 유용합니다. 여러 형식으로 제공되며 IPv4 및 IPv6 데이터를 지원합니다.

IP2Location LITE는 무료 로컬 호스팅 IP 지리적 위치 솔루션을 찾는 개발자에게 좋은 출발점입니다.

IP 지리적 위치 API 및 서비스란 무엇인가요?

IP 지리적 위치 API는 IPv4 또는 IPv6 주소를 지리적 및 네트워크 정보로 변환합니다.

예를 들어, 애플리케이션은 다음을 보낼 수 있습니다:

8.8.8.8

그리고 다음과 같은 정보를 받을 수 있습니다:

  • 국가
  • 지역 또는 주
  • 도시
  • 우편번호
  • 위도 및 경도
  • 시간대
  • ASN
  • ISP
  • 도메인
  • 네트워크 사용 유형
  • 프록시 정보

정확한 필드는 서비스 및 구독 수준에 따라 다릅니다.

IP 지리적 위치 API의 일반적인 용도

IP 지리적 위치는 다음에 유용할 수 있습니다:

  • 웹사이트 및 애플리케이션 현지화
  • 지역 콘텐츠 선택
  • 트래픽 분석
  • 네트워크 문제 해결
  • 보안 조사
  • 사기 위험 분석
  • 로그인 및 인증 컨텍스트
  • 서버 로그 보강
  • IP 주소 연구

이 MCP 서버는 사용자가 REST API 요청을 수동으로 구성할 필요 없이 자연어 프롬프트를 통해 이러한 조회에 액세스할 수 있게 합니다.

IP 주소를 추적할 수 있나요?

IP 주소는 시간이 지남에 따라 애플리케이션에 의해 기록되고 지리적 위치 및 네트워크 데이터로 보강될 수 있습니다.

예를 들어, 보안 애플리케이션은 로그인 이벤트에서 IP 주소를 기록하고 IP 인텔리전스 서비스를 사용하여 다음을 식별할 수 있습니다:

  • 대략적인 국가 또는 도시
  • ASN
  • ISP
  • 네트워크 운영자
  • 프록시 상태
  • 네트워크 또는 지리적 지역의 변경

이는 트래픽 패턴이나 비정상적인 네트워크 활동을 조사하는 데 도움이 될 수 있습니다.

그러나 IP 지리적 위치는 정밀한 개인 또는 기기 추적이 아닙니다.

IP 주소는 다음에 속할 수 있습니다:

  • 공유 가정용 연결
  • 기업 게이트웨이
  • 모바일 통신사
  • VPN
  • 프록시
  • 클라우드 공급자
  • 데이터 센터
  • 많은 사용자가 공유하는 NAT 게이트웨이

IP 지리적 위치 서비스가 반환하는 위도 및 경도는 대략적인 지리적 좌표이며 GPS 좌표, 도로명 주소 또는 개인의 물리적 위치 증거로 해석되어서는 안 됩니다.

이 MCP 서버는 IP 주소 조회를 수행합니다. 자체적으로 IP 주소를 지속적으로 모니터링하거나 추적하지 않습니다.

IP2Location.io를 "내 IP 주소" API로 사용할 수 있나요?

네, IP2Location.io REST API는 이러한 유형의 사용 사례를 지원합니다.

일반적으로 IP 주소가 API에 전달됩니다:

?ip=8.8.8.8

직접 IP2Location.io REST API 요청에서 ip 매개변수를 생략하면 API는 조회를 위해 들어오는 요청과 연결된 IP 주소를 사용할 수 있습니다.

이는 API 요청을 하는 공용 IP에 대한 정보를 확인해야 하는 애플리케이션에 유용합니다.

일반적인 "내 IP" 데이터에는 다음이 포함될 수 있습니다:

  • 공용 IP 주소
  • 국가
  • 지역
  • 도시
  • 좌표
  • 우편번호
  • 시간대
  • ASN 이 저장소의 get_geolocation MCP 도구는 인자로 IP 주소를 기대하므로, MCP 사용은 주로 대화에서 제공된 IP 주소를 조회하도록 설계되었습니다.

ASN 및 IP 주소 조회에 가장 적합한 도구는 무엇인가요?

가장 적합한 도구는 필요한 정보에 따라 달라집니다.

IP2Location.io

IP2Location.io는 동일한 조회에서 ASN 정보와 IP 지리적 위치를 모두 필요로 할 때 유용합니다.

기본 조회 정보는 다음과 같습니다:

  • ASN
  • 자율 시스템(AS) 이름

상위 수준의 IP2Location.io 데이터에는 추가로 다음이 포함될 수 있습니다:

  • AS 번호
  • AS 이름
  • AS 도메인
  • AS CIDR
  • AS 사용 유형

이 MCP 서버를 통해 다음과 같이 질문할 수 있습니다:

What is the ASN of 8.8.8.8?

또는:

Tell me who operates the network for 8.8.8.8 and where the IP is located.

RDAP 및 WHOIS

RDAP 및 WHOIS 서비스는 IP 주소 블록과 조직에 대한 등록 정보가 필요할 때 유용합니다.

특히 IP 범위와 연결된 지역 인터넷 레지스트리(RIR) 레코드를 식별하는 데 유용합니다.

BGP 도구

BGP 룩킹 글래스 및 라우팅 분석 서비스는 다음에 대한 정보가 필요할 때 더 적합합니다:

  • 경로 공지
  • 프리픽스
  • BGP 경로
  • 피어링
  • 라우팅 변경
  • 현재 네트워크를 공지 중인 ASN

IP 인텔리전스 API

IP 인텔리전스 서비스는 여러 데이터 세트를 결합한 구조화된 정보가 애플리케이션에 필요할 때 선호됩니다. 예를 들어:

  • 지리적 위치
  • ASN
  • ISP
  • 프록시 탐지
  • VPN 탐지
  • 네트워크 분류
  • 보안 데이터

동일한 워크플로우에서 지리적 위치와 ASN 정보를 원하는 MCP 사용자에게 이 프로젝트는 IP2Location.io에 대한 편리한 인터페이스를 제공합니다.

ASN 조회 이해하기

자율 시스템 번호(ASN) 는 자율 시스템을 식별합니다: 공통 라우팅 정책에 따라 운영되는 네트워크 또는 IP 프리픽스 모음입니다.

ASN을 보유한 조직의 예는 다음과 같습니다:

  • 인터넷 서비스 제공업체
  • 클라우드 호스팅 제공업체
  • 콘텐츠 전송 네트워크
  • 대학
  • 대기업
  • 통신 회사

ASN 정보는 해당 주소의 라우팅을 담당하는 네트워크를 밝힐 수 있으므로 IP를 조사할 때 유용할 수 있습니다.

예를 들어:

8.8.8.8

는 다음와 연결됩니다:

ASN: 15169
AS: Google LLC

ASN 조회는 일반적으로 다음에 사용됩니다:

  • 네트워크 문제 해결
  • 보안 조사
  • 트래픽 분석
  • 호스팅 제공업체 식별
  • 네트워크별 트래픽 그룹화
  • 의심스러운 IP 주소 조사

IP 지리적 위치 정확도 및 한계

IP 지리적 위치는 네트워크 및 IP 할당 정보를 기반으로 한 추정된 지리적 위치를 제공합니다.

사용자나 장치의 정확한 물리적 위치로 취급해서는 안 됩니다.

정확도는 다음에 의해 영향을 받을 수 있습니다:

  • VPN
  • 프록시 서버
  • 모바일 네트워크
  • 기업 네트워크
  • 통신사급 NAT
  • 위성 연결
  • 클라우드 인프라
  • ISP 라우팅 및 주소 할당 변경

국가 수준의 결과는 일반적으로 정확한 도시 또는 좌표 수준의 결과보다 더 신뢰할 수 있습니다.

IP 지리적 위치를 정밀한 물리적 추적이 아닌 상황별 네트워크 정보로 사용하세요.

IP2Location.io 요금제

반환되는 정보의 양은 IP2Location.io 요금제에 따라 다릅니다.

무료 요금제는 기본 지리적 위치, 기본 ASN 정보, 기본 프록시 탐지를 제공합니다.

상위 요금제는 다음과 같은 추가 정보를 제공할 수 있습니다:

  • ISP
  • 도메인
  • 네트워크 속도
  • 사용 유형
  • 모바일 네트워크 정보
  • 상세 자율 시스템 정보
  • 상세 프록시 정보
  • VPN 탐지
  • Tor 탐지
  • 데이터 센터 탐지
  • 위협 정보
  • 사기 점수
  • 추가 지리적 위치 속성

최신 쿼리 제한, 필드 및 가격에 대해서는 다음을 참조하세요:

리소스

라이선스

LICENSE.TXT 파일을 참조하세요.