IP2Location.io MCP Server

공식

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

GitHub

문서

IP2Location.io MCP 서버

이것은 IP2Location.io API를 위한 간단한 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 주어진 IPv4 또는 IPv6 주소에 대한 상세한 지리적 위치 정보를 반환합니다.

기능

포괄적인 지리적 위치 데이터: 국가, 지역, 도시, 위도, 경도, 우편번호, 시간대 등 광범위한 정보를 조회합니다.
네트워크 세부 정보: ASN, ISP, 도메인, 네트워크 속도 등 네트워크 관련 데이터를 제공합니다.
보안 인사이트: 프록시 유형 및 제공업체를 포함한 프록시 정보를 탐지합니다.
간편한 통합: FastMCP 도구로 구축되어 호환 가능한 시스템에 쉽게 통합할 수 있습니다.
비동기: 논블로킹 비동기 API 요청을 위해 httpx을 활용합니다.

요구 사항

이 MCP 서버는 API 키 없이도 하루 1,000회 쿼리 제한으로 조회를 지원합니다. 또한 무료 API 키를 등록하여 월 최대 50,000회 쿼리를 이용할 수 있습니다.

클라우드 호스팅 MCP 서버를 사용하는 경우, 서버가 원격으로 호스팅되므로 Claude Desktop과 npx만 있으면 됩니다. 원본 MCP 서버를 로컬에서 실행하려면 로컬 설정에 uv이 필요하며, 가이드에 따라 설치할 수 있습니다.

설정

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

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

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

Claude Desktop에서 클라우드 호스팅 IP2Location.io MCP 서버를 사용하려면 아래 단계를 따르세요:

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을 실제 IP2Location.io API 키로 교체하세요. API 키를 얻으려면 대시보드에 로그인하세요.
변경 사항을 저장한 후 Claude Desktop을 다시 시작하면 Connectors 메뉴에 MCP 서버가 나타납니다.

옵션 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 메뉴에 나타납니다.

사용법

Claude Desktop의 채팅에 IP에 대한 쿼리를 입력하기만 하면 됩니다. 몇 가지 예시 쿼리는 다음과 같습니다:

(IP)의 위치는 어디인가요?
(IP)는 어디에 위치해 있나요?
(IP)의 좌표는 무엇인가요?

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

The output of the IP 8.8.8.8

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

또한 IP2Location.io 대량 IP 지리적 위치 API를 활용하여 여러 IP 주소를 쿼리할 수 있습니다. 각 IP 주소 사이에 공백을 넣어 모든 IP 주소를 입력하세요. 예: 8.8.8.8 8.8.6.6.

[!NOTE]
IP2Location.io 대량 IP 지리적 위치 API는 유료 플랜이 필요합니다.

환경 변수

IP2LOCATION_API_KEY

IP2Location.io API 키로, 월 최대 50,000회 쿼리와 더 많은 IP 주소 세부 정보를 조회할 수 있습니다. 무료 API 키를 등록하거나, 더 많은 혜택을 위해 플랜을 구독할 수 있습니다.

도구

get_geolocation

설명 주어진 IP 주소 또는 IP 주소 배치에 대한 지리적 위치를 가져옵니다. 사용자가 모든 IPv4 또는 IPv6 주소에 대해 국가, 지역, 도시, 위도, 경도, 우편번호, 시간대, ASN, 프록시 정보 등의 상세 정보를 조회할 수 있도록 도와줍니다. 여러 IP가 감지되면 효율적인 처리를 위해 요청을 IP2Location.io 대량 API로 자동 라우팅합니다.

인수

ip (str): 분석할 IP 주소(IPv4 또는 IPv6). 쉼표, 공백 또는 줄바꿈으로 구분된 단일 문자열로 전달하여 여러 IP를 한 번에 쿼리할 수 있습니다(예: "1.1.1.1, 2.2.2.2").

반환값 지리적 위치 데이터를 포함하는 JSON 문자열입니다. 여러 IP가 쿼리된 경우, 각 IP 주소가 해당 데이터에 매핑된 JSON 객체를 반환합니다. API 플랜에 따라 결과에 다음 필드가 포함될 수 있습니다:

위치 및 지리: 국가, 지역, 구역, 도시, 우편번호, 위도 및 경도, 시간대.
네트워크 및 연결성: ASN(자율 시스템 번호), ISP(인터넷 서비스 제공업체), 도메인, 네트워크 속도, IDD 코드, 지역 코드, 주소 유형, 사용 유형.
모바일 정보: MNC(모바일 네트워크 코드), MCC(모바일 국가 코드), 모바일 브랜드.
통화 및 언어: 통화 코드, 통화 이름, 통화 기호, 언어 코드, 언어 이름.
프록시 및 보안: 프록시 유형, 마지막 확인 시간, 위협 수준/유형, 프록시 제공업체, 사기 점수.
기타: IAB 카테고리, 날씨, 고도, 인구 등.

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

라이선스

LICENSE 파일을 참조하세요.