MCP 네이버 지도

MCP는 Naver Maps API 및 Naver Search API 에 연결됩니다. 네이버 지도 API와 검색 API에 (로컬) 연결하는 MCP 서버입니다.

현재 다음 API를 지원합니다.

• 지오코딩

• 지역 사에르치

필수 조건

시작하기 전에 다음 사항이 설치되어 있는지 확인하세요.

• Python: 버전 3.13 이상

• uv: 설치 지침은 여기에서 확인할 수 있습니다.

• 네이버 클라우드 플랫폼 계정: 네이버 지도 서비스를 사용하려면 API 자격 증명(클라이언트 ID 및 클라이언트 시크릿)이 필요합니다. 이 정보는 네이버 클라우드 플랫폼 콘솔 에서 확인할 수 있습니다.

• 네이버 개발자 계정: 네이버 개발자 API를 사용하려면 API 자격 증명(클라이언트 ID와 클라이언트 시크릿)이 필요합니다. 이 정보는 네이버 개발자 페이지 에서 받으실 수 있습니다.

Related MCP server: Naver Search MCP Server

구성

1. .env 파일을 만듭니다. 프로젝트 루트에 파일을 만듭니다.

2. API 자격 증명 추가: .env 파일을 편집하여 Naver Maps API 자격 증명과 Naver Developers API 자격 증명을 추가합니다.

   지엑스피1

   src/mcp_naver_maps/naver_maps_client.py 확인하여 필요한 정확한 환경 변수 이름을 확인하세요.

MCP 실행

1. 종속성 동기화: 터미널에서 프로젝트 루트 디렉터리로 이동하여 다음 명령을 실행하세요. 가상 환경이 없는 경우 생성되고 pyproject.toml 에 지정된 모든 종속성이 설치됩니다.

   uv sync

2. 실행: uv 사용하여 MCP 서버를 실행할 수 있습니다.

   uv run src/mcp_naver_maps

   개발을 위해,

   source .venv/bin/activate
   mcp dev src/mcp_naver_maps/server.py