Naver Maps

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

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "yunkee-lee-mcp-naver-maps": {
      "command": "uv",
      "args": [
        "run",
        "src/mcp_naver_maps"
      ],
      "env": {
        "NAVER_CLIENT_API": "YOUR_NAVER_CLIENT_API",
        "NAVER_CLIENT_SECRET": "YOUR_NAVER_CLIENT_SECRET",
        "NAVER_MAPS_CLIENT_ID": "YOUR_NAVER_MAPS_CLIENT_ID",
        "NAVER_MAPS_CLIENT_SECRET": "YOUR_NAVER_MAPS_CLIENT_SECRET"
      }
    }
  }
}

You run an MCP server that connects to the Naver Maps and Naver Search APIs to provide geocoding and local search capabilities for your applications. This MCP makes it simple to query Naver’s map data and local results through a lightweight, configurable server you can host and scale as needed.

How to use

To use this MCP with your client, start the server and point your client to the local MCP endpoint. The server exposes endpoints for geocoding and local search, allowing your applications to translate addresses into coordinates and discover nearby places. You will typically configure your client to send requests to the MCP, which then forwards them to Naver APIs and returns structured results. Ensure your client includes any necessary API credentials handling and error handling so you can gracefully manage quota limits and API errors.

How to install

Prerequisites you need before installing the MCP server:

Python: Version 3.13 or higher

How to install

Step by step install and run flow to get the MCP server up and running on your machine.

uv sync

uv run src/mcp_naver_maps

For development, you can activate the virtual environment and start in development mode:

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

Additional notes

Configuration and security notes follow to help you keep credentials secure and ensure smooth operation. Place your credentials in a local .env file and keep it out of version control. When you run the MCP, the server will load the environment variables to authenticate with Naver Maps and Naver Developers services.

Available tools

Geocoding

Converts addresses and place names into geographic coordinates using the Naver Maps Geocoding API.

Local Search

Finds nearby places and related results using the Naver Local Search API.

Built by

VeilStrat

AI signals for GTM teams