네이버 길찾기 MCP 서버
네이버 지도 API를 사용하여 길찾기, 장소 검색, 지오코딩 기능을 제공하는 MCP(Model Context Protocol) 서버입니다.
기능
- 길찾기: 두 지점 간의 최적 경로 검색
- 장소 검색: 네이버 지도에서 장소 검색
- 지오코딩: 주소를 위도/경도 좌표로 변환
- 역지오코딩: 위도/경도 좌표를 주소로 변환
설치 방법
1. 네이버 클라우드 플랫폼 API 키 발급
- 네이버 클라우드 플랫폼 접속
- 콘솔 로그인 → AI·Application Service → Maps
- 애플리케이션 등록 후 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 IDNAVER_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/