whereami-mcp

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 라이선스. 자세한 내용은 라이선스를 참조하세요.