Skip to main content
Glama
MCP Naver Maps

MCP Naver Maps

by yunkee-lee

MCP Naver Maps

The MCP connects to the Naver Maps API and Naver Search API. 네이버 지도 API와 검색 API에 (로컬) 연결하는 MCP 서버.

It currently supports the following APIs:

Prerequisites

Before you begin, ensure you have the following installed:

  • Python: Version 3.13 or higher

  • uv: You can find installation instructions here.

  • Naver Cloud Platform Account: You need API credentials (Client ID and Client Secret) for the Naver Maps service. You can obtain these from the Naver Cloud Platform console.

  • Naver Develoeprs Account: You need API credentials (Client ID and Client Secret) for the Naver Developers API. You can obtain these from the Naver Developers.

Related MCP server: MCP TMAP Server

Configuration

  1. Create a .env file: Create a file in the project root.

  2. Add API Credentials: Edit the .env file and add your Naver Maps API credentials and Naver Developers API credentials.

    NAVER_MAPS_CLIENT_ID="YOUR_NAVER_MAPS_CLIENT_ID"
    NAVER_MAPS_CLIENT_SECRET="YOUR_NAVER_MAPS_CLIENT_SECRET"
    NAVER_CLIENT_API="YOUR_NAVER_CLIENT_API"
    NAVER_CLIENT_SECRET="YOUR_NAVER_CLIENT_SECRET"

    Please verify the exact environment variable names required by checking src/mcp_naver_maps/naver_maps_client.py.

Running the MCP

  1. Sync Dependencies: Navigate to the project root directory in your terminal and run the following command. This will create a virtual environment (if one doesn't exist) and install all dependencies specified in pyproject.toml.

    uv sync
  2. Run:: You can run the MCP server using uv.

    uv run src/mcp_naver_maps

    For development,

    source .venv/bin/activate
    mcp dev src/mcp_naver_maps/server.py

Available Tools

2 tools
geocodeB

Searches for address information related to the entered address.

Inputs: address (required), language.

localSearchC

Searches for places registered with Naver's local service.

Inputs: query (required), display, sort.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: geocode handles address-to-coordinate conversion, while localSearch finds registered places. There is no overlap in functionality, making it easy for an agent to choose the correct tool based on the task.

    Naming Consistency5/5

    Both tools follow a consistent naming pattern using camelCase (geocode, localSearch) with descriptive verb-noun structures. The naming is uniform and predictable across the set.

    Tool Count2/5

    With only two tools, the server feels under-scoped for a maps domain. While geocoding and local search are core functions, typical maps services include additional operations like routing, place details, or reverse geocoding, making this set appear incomplete.

    Completeness2/5

    For a maps server, there are significant gaps in coverage. Missing tools for routing, reverse geocoding, place details, or map visualization limit an agent's ability to handle common mapping workflows, leading to potential dead ends in tasks.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A server that enables AI models to access Kakao Map features (place search, address lookup, route finding) and Daum search services (web, image, blog, cafe) through Model Context Protocol.
      18
      MIT
    • -
      license
      A
      quality
      Not graded
      maintenance
      Enables users to access Naver Maps API functionality including directions, place search, geocoding, and reverse geocoding through a Model Context Protocol server.
      4
      -
    • F
      license
      A
      quality
      C
      maintenance
      Naver Search API + Datalab API MCP server with 19 tools for Korean web search and trend analysis.
      19
      -