MCP Naver Map

🚀 MCP-NAVER Map

MCP-NAVER Location is an MCP server integrating Naver Cloud's Geolocation API and Directions15 API, offering IP-based location lookup and route planning capabilities.

✨ Features

📍 IP-based Location Lookup

Retrieve an approximate location by providing an IP address.

"Where am I now (IP: xxx.xxx.xxx.xxx)?"
→ 📍 Returns the latitude and longitude corresponding to the provided IP.

• Powered by the NCP Geolocation API.
• Requires manual IP input.

🛣️ Route Planning

Obtain the optimal driving route between two specified points.

"How do I get from the City Hall to Seoul Station?"
→ 🛣️ Returns route instructions.

• Powered by the NCP Directions15 API.

🚀 Quick Start

Prerequisites

• Python 3.12+
• uv package manager
• An activated Naver Cloud Platform account with the following services enabled:
  • Geolocation API
  • Directions15 API
• An MCP-compatible client (e.g., Claude for Desktop)

1. Clone and Setup

# Clone the repository
git clone https://github.com/yourusername/mcp-naver-location.git
cd mcp-naver-map

# Install dependencies
uv sync

Create a .env file containing your credentials:

NAVER_ACCESS_KEY_ID=your_access_key_id
NAVER_SECRET_KEY=your_secret_key
MAP_CLIENT_ID=your_map_client_id
MAP_CLIENT_SECRET=your_map_client_secret

2. Configure the MCP Client

Register this server in your MCP client (e.g., Claude for Desktop).

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-naver-location": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-naver-location",
        "run",
        "server"
      ]
    }
  }
}

3. Launch Claude

⚠️ Important Note: You must launch Claude from the terminal to establish a proper connection with the MCP server.

# macOS:
/Applications/Claude.app/Contents/MacOS/Claude

# Windows:
"C:\Program Files\Claude\Claude.exe"

📄 License

• This project is released under the MIT License. For more details, please refer to the LICENSE file.
• Built using the Model Context Protocol