Naver Maps MCP Server

This project is a server that provides Naver Maps API through the Model Context Protocol (MCP). It allows AI applications to utilize Naver Maps API features such as geocoding, reverse geocoding, and route searching.

Features

This MCP server provides the following Naver Maps API features:

• Geocoding: Convert addresses to coordinates (latitude, longitude)
• Reverse Geocoding: Convert coordinates to addresses
• Place Search: Search places based on keywords
• Route Search: Provide optimal routes between two points
• Route Search with Waypoints: Provide optimal routes including waypoints
• Coordinate System Conversion: Convert between various coordinate systems

Getting Started

Prerequisites

• Node.js 18.0.0 or higher
• Naver Cloud Platform API credentials (Client ID, Client Secret)

Installation

1. Clone the repository:

git clone https://github.com/devyhan/naver-maps-mcp.git
cd naver-maps-mcp

2. Install dependencies:

npm install

3. Set up environment variables:

Copy the .env.example file to create a .env file and set the necessary environment variables:

cp .env.example .env

Edit the .env file to enter your Naver API authentication information:

NAVER_CLIENT_ID=your_client_id_here
NAVER_CLIENT_SECRET=your_client_secret_here

Running

npm start

Testing

npm test

Testing with MCP Inspector

You can test the server using MCP Inspector:

npx @modelcontextprotocol/inspector node index.js

Using with Claude Desktop

To use this server with Claude Desktop:

1. Create a claude_desktop_config.json file in Claude Desktop's configuration directory:

{
  "naverMaps": {
    "command": "node",
    "args": ["/Users/your-username/path/to/naver-maps-mcp/index.js"],
    "env": {
      "NAVER_CLIENT_ID": "your_client_id_here",
      "NAVER_CLIENT_SECRET": "your_client_secret_here"
    }
  }
}

2. Restart Claude Desktop.

Usage Examples

Geocoding (Address → Coordinates)

Tool: geocode
Parameters: 
{
  "address": "서울특별시 강남구 테헤란로 129"
}

Reverse Geocoding (Coordinates → Address)

Tool: reverseGeocode
Parameters:
{
  "latitude": 37.5058,
  "longitude": 127.0556
}

Route Search

Tool: getDirections
Parameters:
{
  "start": {
    "latitude": 37.5058,
    "longitude": 127.0556
  },
  "goal": {
    "latitude": 37.5662,
    "longitude": 126.9784
  },
  "option": "trafast"
}

Project Structure

naver-maps-mcp/
├── index.js              # Entry point
├── package.json          # Project metadata
├── .env.example          # Environment variables example
├── README.md             # Project documentation
├── src/
│   ├── server.js         # MCP server implementation
│   ├── api/
│   │   └── naverMapsClient.js  # Naver API client
│   └── utils/
│       ├── config.js     # Configuration management
│       └── logger.js     # Logging utility
└── tests/
    └── test.js           # Test code

License

ISC

References

• Model Context Protocol
• Naver Cloud Platform Maps API