근처 검색 MCP 서버

IP 기반 위치 감지 기능을 갖춘 근처 장소 검색을 위한 MCP 서버입니다.

특징

• IP 기반 위치 감지 : ipapi.co를 사용하여 현재 위치를 확인합니다.

• Google Places 통합 : 키워드 및 선택적 유형 필터를 기반으로 주변 장소 검색

• 간단한 인터페이스 : 사용자 정의 반경을 갖춘 단일 도구 끝점

Related MCP server: GeoIP MCP Server

요구 사항

• 파이썬 3.10+

• Places API가 활성화된 Google Cloud Platform API 키

• 인터넷 연결

설치

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

지엑스피1

2. 종속성 설치:

# Using uv (recommended)
uv add "mcp[cli]" httpx python-dotenv

# Or using pip
pip install mcp httpx python-dotenv

3. 클라이언트 구성

{
  "mcpServers": {
    "nearby-search": {
      "command": "uv",
      "args": ["--directory", "path/to/nearby-search-mcp", "run", "main.py"],
      "env": {
        "GOOGLE_API_KEY": "your google api key"
      }
    }
  }
}

용법

서버 실행

• 개발 모드 (MCP 검사기 포함):

mcp dev main.py

• Claude Desktop에 설치 :

mcp install main.py --name "NearbySearch"

• 직접 실행 :

python main.py

사용 가능한 엔드포인트

도구: search_nearby

• 현재 위치 근처 장소 검색

• 매개변수:

  • keyword (str): 검색할 내용(예: "커피숍")

  • radius (int, 선택 사항): 검색 반경(미터 단위)(기본값: 1500)

  • type (str, 선택 사항): 장소 유형(예: "레스토랑", "카페")

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.