kakao-navigation

This MCP server provides Kakao Mobility and Kakao Map integration, enabling location-based services such as geocoding and route finding. It exposes MCP tools including geocode for converting addresses to coordinates, direction_search_by_names and direction_search_by_coordinates for route planning between two points (by addresses or coordinates), future_direction_search_by_coordinates for time-aware routing, and address_search_by_place_name to locate addresses by place name. You can leverage these tools to build travel planning features, delivery routing, or map-enabled applications that rely on Kakao's mapping and mobility data. Typical usage involves querying the geocode tool to resolve user-provided addresses, then feeding those coordinates into the direction search tools to obtain optimal routes, while optionally using real-time traffic data to refine results.

Prerequisites:

• Node.js (12.x or newer) and npm installed
• Access to Kakao REST API key and required Kakao Map services enabled

1. Clone the MCP server repository:

git clone https://github.com/cachij/kakao-navigation-mcp-server.git
cd kakao-navigation-mcp-server

2. Install dependencies:

npm install

3. Configure environment variables Create a .env file or set environment variables with your Kakao credentials:

# .env
KAKAO_REST_API_KEY=your-rest-api-key
KAKAO_CLIENT_ID=your-client-id
KAKAO_CLIENT_SECRET=your-client-secret
LOG_LEVEL=info

4. Run the MCP server (via npm script or directly):

npm run start

If you use the MCP config approach, you can start with the following command selecting the MCP package name:

npx -y cachij-kakao-navigation-mcp-server

Tips:

• Ensure Kakao API keys are kept secure and not exposed in front-end code. Use server-side calls where possible.
• If you encounter rate limiting, consider staggering requests or applying for higher quota with Kakao.
• The MCP server can be integrated with other MCP-compliant services by wiring its tools into your data flow through the MCP protocol.
• Common env vars: KAKAO_REST_API_KEY, KAKAO_CLIENT_ID, KAKAO_CLIENT_SECRET. Adjust LOG_LEVEL for debugging.
• Check that your deployment environment allows outbound requests to Kakao API endpoints and that the correct REST API key is used for the environment (development vs. production).