mcp-naver-map

MCP.Pizza Chef: yeonupark

The mcp-naver-map is an MCP server integrating Naver Cloud's Geolocation and Directions15 APIs to provide IP-based location lookup and optimal route finding. It enables retrieval of approximate geographic coordinates from IP addresses and driving directions between locations, supporting real-time geospatial queries within MCP-enabled workflows.

Use This MCP server To

Retrieve geographic coordinates from an IP address Find optimal driving routes between two locations Integrate location-based services into MCP workflows Enable real-time geolocation queries in chatbots Provide route guidance in travel or delivery apps Support location-aware automation in AI agents

README

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

mcp-naver-map FAQ

How do I set up the mcp-naver-map server?
Install Python 3.12+, use the uv package manager, and activate Naver Cloud's Geolocation and Directions15 APIs.
Can I use mcp-naver-map without a Naver Cloud account?
No, you must have an active Naver Cloud Platform account with the required APIs enabled.
What input does the IP-based location lookup require?
It requires a manual IP address input to return approximate latitude and longitude.
How does route finding work in mcp-naver-map?
It uses Naver Cloud's Directions15 API to provide optimal driving directions between two specified points.
Is mcp-naver-map compatible with multiple MCP clients?
Yes, it works with any MCP-compatible client such as Claude for Desktop.
What programming language is used for mcp-naver-map?
The server is implemented in Python 3.12+.
Can mcp-naver-map handle real-time location queries?
Yes, it supports real-time geolocation and routing queries within MCP workflows.
Are there any usage limits or costs?
Usage limits and costs depend on your Naver Cloud Platform subscription and API usage.