WhereAmI MCP 서버

ipapi.co 에서 제공하는 현재 IP를 기반으로 사용자의 정확한 위치를 알려주는 가벼운 MCP 서버입니다.

특징

• 동적 리소스 : location://{type} 통해 특정 데이터(예: IP, 국가, 도시)를 가져옵니다.

• 자세한 도구 : get_location() 사용하여 포괄적인 위치 보고서를 생성합니다.

• 자연어 프롬프트 : "내가 어디에 있나요?"라고 물으면 자세한 결과를 얻을 수 있습니다.

• 강력한 오류 처리 : API 및 네트워크 문제를 원활하게 관리합니다.

• 최소 종속성 : mcp 및 httpx 만 필요합니다.

설치

필수 조건

• 파이썬 3.10+

• pip

설정

1. 저장소를 복제합니다.

   지엑스피1

2. 종속성 설치:

   pip install mcp httpx

3. (선택 사항) MCP 서비스로 설치:

   mcp install whereami_mcp.py --name "WhereAmI"

용법

서버 실행

• 직접 실행:

  python whereami_mcp.py

• 개발 모드:

  mcp dev whereami_mcp.py

구성 요소

리소스: location://{type}

{type} 에 따라 특정 위치 세부 정보를 반환합니다.

• 지원 유형 : ip , country , country_code , region , city , latitude , longitude , timezone , isp , asn

• 예시 :

  • @location://ip → "8.8.8.8"

  • @location://city → "Mountain View"

  • @location://country → "United States"

도구: get_location()

지리적 위치 데이터에 대한 자세한 마크다운 테이블을 생성합니다.

• 분야 :

  • 아이피

  • 국가

  • 국가 코드

  • 지역

  • 도시

  • 위도

  • 경도

  • 시간대

  • 인터넷 서비스 제공자

  • ASN

• 샘플 출력 :

  | Field | Value | |----------------|-------------------| | IP | 8.8.8.8 | | Country | United States | | Country Code | US | | Region | California | | City | Mountain View | | Latitude | 37.4223 | | Longitude | -122.0848 | | Timezone | America/Los_Angeles | | ISP | GOOGLE | | ASN | AS15169 |

프롬프트: where_am_i_prompt

미리 정의된 쿼리: "현재 IP 주소를 기준으로 내가 어디에 있는지 알려주세요." get_location() 트리거합니다.

Claude Desktop의 예

1. 서버를 설치하세요:

   mcp install whereami_mcp.py --name "WhereAmI"

2. 쿼리 데이터:

   • "내 IP는 @location://ip 입니다"

   • "저는 @location://city , @location://country 있습니다."

3. 전체 보고서 받기:

   • "나는 어디에 있나요?"

   • get_location()

특허

MIT 라이선스. 자세한 내용은 라이선스를 참조하세요.