네이버 길찾기 MCP 서버

네이버 지도 API를 사용하여 길찾기, 장소 검색, 지오코딩 기능을 제공하는 MCP(Model Context Protocol) 서버입니다.

기능

• 길찾기: 두 지점 간의 최적 경로 검색
• 장소 검색: 네이버 지도에서 장소 검색
• 지오코딩: 주소를 위도/경도 좌표로 변환
• 역지오코딩: 위도/경도 좌표를 주소로 변환

설치 방법

1. 네이버 클라우드 플랫폼 API 키 발급

1. 네이버 클라우드 플랫폼 접속
2. 콘솔 로그인 → AI·Application Service → Maps
3. 애플리케이션 등록 후 Client ID와 Client Secret 발급

2. Smithery를 통한 설치

# Smithery로 설치
smithery install naver-directions-mcp

# 환경변수 설정
smithery config naver-directions-mcp

3. 수동 설치

# 패키지 설치
npm install -g naver-directions-mcp

# 또는 로컬 개발
git clone https://github.com/your-username/naver-directions-mcp.git
cd naver-directions-mcp
npm install

설정

Claude Desktop 설정

claude_desktop_config.json 파일에 다음 내용을 추가:

{
  "mcpServers": {
    "naver-directions": {
      "command": "naver-directions-mcp",
      "env": {
        "NAVER_CLIENT_ID": "your_client_id",
        "NAVER_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

환경변수

• NAVER_CLIENT_ID: 네이버 클라우드 플랫폼 Client ID
• NAVER_CLIENT_SECRET: 네이버 클라우드 플랫폼 Client Secret

사용 방법

길찾기

// 주소로 길찾기
{
  "start": "서울특별시 강남구 테헤란로 152",
  "goal": "서울특별시 종로구 세종대로 175",
  "option": "trafast"
}

// 좌표로 길찾기
{
  "start": "127.0276,37.4981",
  "goal": "126.9780,37.5665",
  "option": "tracomfort"
}

장소 검색

{
  "query": "강남역 맛집",
  "display": 5
}

지오코딩

{
  "address": "서울특별시 강남구 테헤란로 152"
}

역지오코딩

{
  "lat": 37.4981,
  "lng": 127.0276
}

경로 옵션

• trafast: 실시간 빠른길 (기본값)
• tracomfort: 편안한길
• traoptimal: 최적경로
• trainormal: 일반도로

응답 형식

길찾기 응답

{
  "distance": "15.2km",
  "duration": "25분",
  "tollFare": "1,200원",
  "fuelPrice": "2,850원",
  "start": [127.0276, 37.4981],
  "goal": [126.978, 37.5665],
  "path": ["[37.4981, 127.0276]", "[37.4985, 127.0280]", "..."],
  "pathCount": 245
}

개발 및 테스트

# 개발 모드 실행
npm run dev

# 테스트
npm test

# 직접 실행
node index.js

라이선스

MIT License

기여

이슈와 PR을 환영합니다!

지원

• 네이버 클라우드 플랫폼 Maps API 문서: https://api.ncloud-docs.com/docs/ai-naver-mapsgeocoding
• MCP 공식 문서: https://modelcontextprotocol.io/