Skip to main content
Glama
Chaeyun06

네이버 길찾기 MCP 서버

by Chaeyun06

네이버 길찾기 MCP 서버

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

기능

  • 길찾기: 두 지점 간의 최적 경로 검색

  • 장소 검색: 네이버 지도에서 장소 검색

  • 지오코딩: 주소를 위도/경도 좌표로 변환

  • 역지오코딩: 위도/경도 좌표를 주소로 변환

Related MCP server: MCP Google Map Server

설치 방법

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을 환영합니다!

지원

Available Tools

4 tools

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 4 tool updatesv1.0.0
    • First observednaver_directions
    • First observednaver_geocode
    • First observednaver_reverse_geocode
    • First observednaver_search_places

TDQS

A3.5/5.0

Scored across 4 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: directions for routing, geocode for address-to-coordinates, reverse_geocode for coordinates-to-address, and search_places for location search. There is no overlap in functionality, making tool selection straightforward.

Naming Consistency5/5

All tools follow a consistent 'naver_' prefix and snake_case naming pattern (e.g., naver_directions, naver_geocode). This uniformity enhances readability and predictability across the toolset.

Tool Count5/5

With 4 tools, the server is well-scoped for a navigation and mapping domain. Each tool serves a core function (routing, geocoding, reverse geocoding, place search), and there are no redundant or missing tools for this purpose.

Completeness5/5

The toolset provides complete coverage for basic navigation workflows: converting addresses to coordinates, coordinates to addresses, finding places, and getting directions. There are no obvious gaps, as these tools support end-to-end routing tasks.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that provides access to Naver OpenAPI services, enabling users to search blogs, news, books, images, and other content through standardized Model Context Protocol interfaces.
    114
    MIT
  • A
    license
    B
    quality
    A
    maintenance
    A Model Context Protocol server that provides Google Maps API integration, allowing users to search locations, get place details, geocode addresses, calculate distances, obtain directions, and retrieve elevation data through LLM processing capabilities.
    7
    3,246 npm
    459
    MIT
  • A
    license
    C
    quality
    D
    maintenance
    Provides access to Google Maps API functionality including geocoding, place search, direction routing, and distance calculations through a structured MCP interface.
    4
    2 npm
    MIT