MCP-NAVER-Map

MCP-NAVER-Map

MCP-NAVER-Location is an MCP server that integrates with Naver Cloud's Geolocation API and Directions15 API to provide IP-based location lookup and route finding capabilities.

---

✨ Features

📍 IP-Based Location Lookup

Retrieve an approximate location by providing an IP address.

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

• Powered by NCP Geolocation API
• Manual IP input required

🛣️ Route Finding

Get optimal driving directions between two specified points.

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

• Powered by NCP Directions15 API

---

🚀 Quick Start

Prerequisites

• Python 3.12+
• uv package manager
• Naver Cloud Platform account and API services activated:
  • Geolocation API
  • Directions15 API
• 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 with your credentials:

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

2. Configure 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: Claude must be launched from the terminal to establish a proper connection to the MCP server.

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


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

---

📝 License

• This project is licensed under the MIT License. See the LICENSE file for details.
• Built with Model Context Protocol