mcp-naver-map

mcp-naver-map

3.3

If you are the rightful owner of mcp-naver-map and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

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.

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