MCP Naver Maps

The MCP connects to the Naver Maps API and Naver Search API. 네이버 지도 API와 검색 API에 (로컬) 연결하는 MCP 서버.

It currently supports the following APIs:

• Geocoding
• Local saerch

Prerequisites

Before you begin, ensure you have the following installed:

• Python: Version 3.13 or higher
• uv: You can find installation instructions here.
• Naver Cloud Platform Account: You need API credentials (Client ID and Client Secret) for the Naver Maps service. You can obtain these from the Naver Cloud Platform console.
• Naver Develoeprs Account: You need API credentials (Client ID and Client Secret) for the Naver Developers API. You can obtain these from the Naver Developers.

Configuration

1. Create a .env file: Create a file in the project root.

2. Add API Credentials: Edit the .env file and add your Naver Maps API credentials and Naver Developers API credentials.

   NAVER_MAPS_CLIENT_ID="YOUR_NAVER_MAPS_CLIENT_ID"
   NAVER_MAPS_CLIENT_SECRET="YOUR_NAVER_MAPS_CLIENT_SECRET"
   NAVER_CLIENT_API="YOUR_NAVER_CLIENT_API"
   NAVER_CLIENT_SECRET="YOUR_NAVER_CLIENT_SECRET"
   

   Please verify the exact environment variable names required by checking src/mcp_naver_maps/naver_maps_client.py.

Running the MCP

1. Sync Dependencies: Navigate to the project root directory in your terminal and run the following command. This will create a virtual environment (if one doesn't exist) and install all dependencies specified in pyproject.toml.

   uv sync
   

2. Run:: You can run the MCP server using uv.

   uv run src/mcp_naver_maps
   

   For development,

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