IPGeolocation.io MCP 서버

IPGeolocation.io를 위한 공식 MCP 서버입니다. 16개의 MCP 도구가 포함되어 있습니다: IP 위치 정보, 위협/VPN/프록시 탐지, 시간대 조회 및 변환, 일출/일몰/달 데이터, ASN 세부 정보, 악용 연락처 및 사용자 에이전트 파싱. 7개의 도구는 무료 플랜(일일 1,000 크레딧)에서 작동합니다. 유료 플랜은 16개 도구 전체와 대량 엔드포인트(호출당 최대 1,000개 항목)를 잠금 해제합니다.

Claude Desktop, Cursor, Windsurf, VS Code, Codex, Cline, Glama 및 기타 모든 MCP 클라이언트와 호환됩니다.

빠른 시작

1. 무료 IPGeolocation API 키 생성

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 사용 가능

• 대부분의 도구에 IPGeolocation.io API 키 필요

get_my_ip는 API 키 없이 작동합니다. 그 외 모든 도구는 키가 필요합니다.

무료 IPGeolocation API 키 가입

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을 다시 시작하세요. MCP 번들을 지원하는 클라이언트를 위해 manifest.json도 제공합니다.

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

VS Code settings.json에 추가하세요:

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

저장 후 VS Code를 다시 시작하세요.

Glama

Glama에서 서버를 직접 사용해 볼 수 있습니다. IPGEOLOCATION_API_KEY만 필요합니다. 캐시, 시간 초과 또는 출력 제한을 변경하려는 경우가 아니면 다른 환경 변수 필드는 비워 두세요.

아직 키가 없다면 무료 IPGeolocation API 키를 생성하세요.

기타 MCP 클라이언트

이 설정을 사용하세요:

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

작동 확인

설정 후 다음을 시도해 보세요:

플랜별 도구

무료 플랜

일일 1,000 크레딧. 다음 7가지 도구를 사용할 수 있습니다:

유료 플랜

16개 도구 전체. 유료 플랜은 lookup_ip에 network, company, 확장된 asn 필드를 추가하며, security, abuse, hostname, liveHostname, hostnameFallbackLive, user_agent, geo_accuracy, dma_code 또는 *에 대한 include 매개변수를 지원합니다.

include를 사용한 lookup_ip의 크레딧 계산:

현재 플랜 세부 정보 및 가격은 IPGeolocation 가격 페이지를 참조하세요.

도구 참조

lookup_ip

단일 IP 또는 도메인 조회. 무료 및 유료. 1 크레딧.

하나의 IP 주소에 대해 위치, 시간대, 통화 또는 ASN이 필요할 때 사용하세요. 유료 플랜에서는 include 모듈을 추가하여 보안, 악용 또는 호스트 이름 데이터를 동일한 호출로 가져올 수 있어 추가 요청을 방지합니다.

무료 플랜은 기본 위치, 국가 메타데이터, 통화, 시간대 및 기본 ASN을 반환합니다. 유료 플랜은 network, company, 확장된 ASN 및 include 매개변수를 추가합니다. 도메인 조회는 유료 플랜이 필요합니다.

팁: include와 fields를 결합하면 크레딧 비용을 절감할 수 있습니다. 예를 들어, include=security&fields=security는 기본 위치 정보 응답을 건너뛰므로 3 크레딧 대신 2 크레딧이 소요됩니다. 마찬가지로 include=abuse&fields=abuse는 2 크레딧 대신 1 크레딧이 소요됩니다.

bulk_lookup_ip

일괄 IP 조회. 유료. IP당 1 크레딧.

IP 또는 도메인 배열을 가져옵니다(기본값 최대 1,000개, IPGEOLOCATION_MCP_MAX_BULK_ITEMS로 구성 가능). lookup_ip와 동일한 include, fields, excludes 옵션을 지원합니다.

get_my_ip

서버를 실행 중인 머신의 공용 IP를 반환합니다. 무료. 0 크레딧. API 키 불필요.

매개변수가 없습니다. 항상 네트워크를 호출합니다(캐시되지 않음). 서버 프로세스가 실행 중인지 확인하는 빠른 방법으로 유용합니다.

check_security

하나의 IP에 대한 위협 및 익명성 데이터. 유료. 2 크레딧.

위협 점수, VPN/프록시/Tor 플래그, 제공자 이름, 신뢰도 점수, 봇/스팸 지표, 익명성 플래그 및 클라우드 제공자 상태를 반환합니다.

동일한 프롬프트에서 위치, ASN 또는 악용 데이터를 함께 요청하는 경우, lookup_ip와 include=security를 사용하는 것이 좋습니다. 한 번의 호출로 모든 것을 번들로 제공하기 때문입니다(별도로 2 + 1을 호출하는 대신 총 3 크레딧).