mcp-naver-maps

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