MCP Naver Maps

🚀 MCP Naver Maps

The MCP server connects to the Naver Maps API and Naver Search API, providing local connections to these APIs.

It currently supports the following APIs:

• Geocoding
• Local search

🚀 Quick Start

✨ Features

• Connects to Naver Maps API and Naver Search API.
• Supports Geocoding and Local search APIs.

📦 Installation

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 Developers 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