iNavi Maps Docs

Name: iNavi Maps Docs
Author: inavi-systems

von inavi-systemsVersion 0.4.2i★ –iLäuft auf deinem Computer

Name in der Registryio.github.inavi-systems/inavi-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

iNavi Maps docs for AI (South Korea): API specs, Web JS SDK reference, HTML map templates

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Reisen, Karten & Wetter

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Die Registry nennt keinen Schlüssel zum Eintragen.

Du brauchst

npmNode.js installiert (für den Befehl npx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "inavi": {
      "command": "npx",
      "args": [
        "-y",
        "@inavi-maps/mcp-server"
      ]
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add inavi -- npx -y @inavi-maps/mcp-server

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "inavi": {
      "command": "npx",
      "args": [
        "-y",
        "@inavi-maps/mcp-server"
      ]
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "inavi": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@inavi-maps/mcp-server"
      ]
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 8. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto inavi-systems bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Reisen, Karten & Wetteri

Mehr Sterne als 0 % der anderen 1716 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 67 % der anderen 1716 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 1716 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist iNavi Maps Docs sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.4.2) kam vor 15 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Maproll, Agro API MCP by usefulapi, FieldClimate MCP by usefulapi

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Maproll

von maproll-io

Make production-ready static maps. Every map is a URL you can embed anywhere.

Läuft auf deinem ComputerAktualisiert heute

Installieren

Agro API MCP by usefulapi

von m190

Read satellite, NDVI, weather and soil data; create and delete fields in Agro API.

Läuft in der CloudAktualisiert heute

Installieren

FieldClimate MCP by usefulapi

von m190

Read weather station data, sensors, farms, fields and crop zones in FieldClimate.

Läuft in der CloudAktualisiert heute

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

INAVI Maps Docs MCP Server

AI 어시스턴트에 지도 인텔리전스를 부여하는 MCP (Model Context Protocol) 서버입니다.

INAVI Maps Docs MCP Server를 연결하면, AI가 INAVI Maps의 위치 기반 API와 Web JS SDK를 이해하고 인터랙티브 지도를 직접 생성할 수 있게 됩니다. 별도의 문서를 읽거나 코드를 직접 작성할 필요 없이, 자연어로 대화하며 지도 기반 기능을 구현할 수 있습니다.

API 명세 - 지오코딩, POI 검색, 경로 탐색, 맵 매칭 등 30개 이상의 INAVI Maps API 명세(OAS 기반)를 AI에게 제공
지도 SDK 예제 - 마커, 클러스터, 폴리곤, 폴리라인 등 바로 실행되는 18개의 지도 SDK 예제로 인터랙티브 지도 생성
SDK 레퍼런스 - Web JS SDK의 클래스·메서드·옵션·이벤트 정의를 제공해, 예제에 없는 기능도 실제 시그니처대로 작성

이런 분들에게 적합합니다:

빠른 프로토타이핑 - API 문서를 읽지 않고 AI 대화만으로 지도 기반 기능 구현
위치 기반 서비스 개발 - 지오코딩, 경로 탐색, POI 검색 등을 활용한 서비스 구축
데이터 시각화 - 위치 데이터를 인터랙티브 지도 위에 시각화

빠른 시작

방법 1: .mcpb Bundle (Claude Desktop 전용 - 추천)

가장 쉬운 설치 방법입니다. 별도 환경 구성 없이 바로 사용할 수 있습니다.

GitHub Releases에서 최신 .mcpb 파일 다운로드
다운로드한 .mcpb 파일을 Claude Desktop에 드래그 앤 드롭 (또는 더블클릭)
Claude Desktop 재시작

완료! 이제 Claude에게 지도 관련 질문을 할 수 있습니다.

방법 2: npx (모든 MCP 호스트)

Cursor, VS Code, Claude Code, Codex, Windsurf 등 다양한 MCP 호스트에서 사용할 수 있습니다.

사전 요구사항: Node.js 22 이상이 설치되어 있어야 합니다.

표준 설정 — 대부분의 MCP 호스트에서 그대로 사용할 수 있습니다.

"mcpServers": { "inavi-maps-mcp": { "command": "npx", "args": ["-y", "@inavi-maps/mcp-server"] } } }

사용 중인 도구를 펼쳐 설정 위치를 확인하세요.

Cursor

위 Install in Cursor 버튼을 누르거나, ~/.cursor/mcp.json에 표준 설정을 추가합니다. (공식 가이드)

VS Code

위 Install in VS Code 버튼을 누르거나, 다음 명령을 실행합니다. (공식 가이드)

code --add-mcp '{"name":"inavi-maps-mcp","command":"npx","args":["-y","@inavi-maps/mcp-server"]}'

설정 파일을 직접 편집할 때는 최상위 키가 mcpServers가 아닌 servers입니다.

Claude Code

claude mcp add --transport stdio inavi-maps-mcp -- npx -y @inavi-maps/mcp-server

또는 ~/.claude.json에 표준 설정을 추가합니다. (공식 가이드)

Claude Desktop

claude_desktop_config.json에 표준 설정을 추가합니다. (공식 가이드)

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Codex

codex mcp add inavi-maps-mcp -- npx -y @inavi-maps/mcp-server

또는 ~/.codex/config.toml에 추가합니다 (TOML 형식). (공식 가이드)

[mcp_servers.inavi-maps-mcp]

command = "npx" args = ["-y", "@inavi-maps/mcp-server"]

Windsurf

~/.codeium/windsurf/mcp_config.json에 표준 설정을 추가합니다. (공식 가이드)

사용 예시

MCP 서버를 설치한 후, AI에게 자연어로 요청하세요.

API 탐색 & 코드 생성

이 MCP 서버는 INAVI Maps API 명세를 AI에게 제공합니다. AI가 직접 API를 호출하는 것이 아니라, API 명세를 참조하여 올바른 호출 코드를 작성해 줍니다.

INAVI Maps에서 사용할 수 있는 지오코딩 관련 API를 알려줘

리버스 지오코딩 API의 요청/응답 명세를 보여줘

주소를 좌표로 변환하는 API 호출 코드를 TypeScript로 작성해줘

출발지-도착지 경로 탐색 API를 사용하는 예제 코드를 만들어줘

N:1 거리 매트릭스 API로 가장 가까운 매장을 찾는 로직을 구현해줘

지도 시각화

AI가 지도 SDK 예제로 동작하는 페이지를 먼저 구성하고, 예제에 없는 옵션·메서드·이벤트는 SDK 레퍼런스에서 확인해 반영합니다.

INAVI Maps 지도에 마커를 표시하는 HTML 페이지를 만들어줘

여러 지점을 클러스터로 묶어서 지도에 표시하는 페이지를 만들어줘

경로를 교통 상황 색상으로 지도에 시각화하는 페이지를 만들어줘

서울 주요 관광지를 폴리곤 영역과 마커로 표시하는 지도를 만들어줘

클러스터에서 마커를 클릭하면 해당 장소의 정보를 InfoWindow로 보여줘

SDK 레퍼런스 조회

Web JS SDK의 클래스·메서드·옵션 정의를 AI가 기억에 의존해 추측하지 않고 확인한 뒤 답변합니다.

Marker에서 사용할 수 있는 이벤트와 옵션을 알려줘

Map#fitBounds의 파라미터와 옵션을 알려줘

Polyline 선 스타일(LineStyle)로 지정할 수 있는 값을 정리해줘

조합 활용

API 명세, 지도 SDK 예제, SDK 레퍼런스를 함께 사용하면 더 복잡한 기능을 구현할 수 있습니다.

지오코딩 API로 주소를 좌표로 변환하고, 그 결과를 지도에 마커로 표시하는 페이지를 만들어줘

경로 탐색 API 호출 결과를 지도 위에 폴리라인으로 그리고, 지도 범위를 경로 전체에 맞춰줘

사용 가능한 도구

이 MCP 서버는 세 종류, 총 6개의 도구를 제공합니다. 각 도구 쌍은 탐색 → 상세 조회의 2단계 워크플로우로 설계되어 있습니다.

API 명세 도구

INAVI Maps API 명세(OAS 기반)를 AI에게 제공하여, API 문서를 직접 읽지 않고도 AI가 올바른 API 호출 코드를 작성할 수 있도록 합니다.

도구	설명	주요 입력
`list_api_specs`	API 명세 목록 조회	`category` (선택)
`get_api_spec`	특정 API 상세 명세 조회	`operationId` (필수)

워크플로우: list_api_specs로 사용 가능한 API를 탐색한 후, get_api_spec에 operationId를 전달하여 파라미터, 요청/응답 스키마 등 상세 명세를 조회합니다.

API 명세 카테고리 (8개)

카테고리	설명	포함 API
`search-place`	장소/주소 검색	통합 검색, 다국어 통합 검색, 장소 상세 조회, 시설물 정보 조회, 검색어 추천, 주변 카테고리 검색, 최적 지점 검색
`search-geocoding`	지오코딩	지오코딩, 리버스 지오코딩
`search-spatial`	공간 검색	공간 검색, 행정/법정동 영역 검색, 좌표(계) 변환
`search-w3w`	what3words	W3W 검색어 추천, W3W 리버스 지오코딩, W3W 최적 지점 검색
`route-directions`	경로 탐색	경로 탐색, 경로 탐색 요약, 경로 예측 탐색, 다중 경유지 탐색 100, 도보/PM 경로 탐색
`route-optimization`	경유지 최적화	TSP 10, TSP 30, TSP 50, TSP 100 (다중 경유지 최적화)
`route-map-matching`	맵 매칭	Special Map Matching, MTR 100, MTR 1000
`route-matrix`	거리/시간 매트릭스	N:1, 1:N, M:N 매트릭스

지도 SDK 예제 도구

SDK 로더부터 지도 초기화까지 포함된, 바로 실행되는 지도 SDK 예제(HTML)를 제공합니다. AI가 예제의 데이터 값(좌표, 레이블 등)을 커스터마이징하여 맞춤형 지도 페이지를 생성합니다.

도구	설명	주요 입력
`list_map_examples`	지도 SDK 예제 목록 조회	`category` (선택)
`get_map_example`	특정 지도 SDK 예제의 HTML 코드 조회	`id` (필수)

워크플로우: list_map_examples로 사용 가능한 예제를 탐색한 후, get_map_example에 id를 전달하여 완전한 HTML 코드를 조회합니다.

지도 SDK 예제 카테고리 (4개, 총 18개 예제)

카테고리	예제 수	포함 예제
`dynamic-maps`	5	기본 지도, 지도 정보 표시, 거리 계산, 지도 타입 전환, FlyTo 애니메이션
`marker`	6	기본 마커, 이동 가능 마커, 클러스터, 클러스터 격자 크기, 넘버링, 컬러 마커
`infowindow`	2	기본 InfoWindow, 클러스터 마커 InfoWindow
`shapes`	5	원, 폴리곤, 멀티 폴리곤, 스타일 변경, 폴리라인 (교통 색상)

SDK 레퍼런스 도구

INAVI Maps Web JS SDK의 클래스와 옵션/타입 정의를 제공합니다. 지도 SDK 예제에 없는 옵션·메서드·이벤트를 AI가 기억에 의존해 추측하지 않고, 실제 시그니처를 확인한 뒤 작성하도록 합니다.

도구	설명	주요 입력
`list_sdk_docs`	SDK 레퍼런스 심볼 목록 조회 (클래스는 메서드명 포함)	`category` (선택)
`get_sdk_doc`	특정 심볼 또는 단일 메서드의 SDK 레퍼런스 조회	`docId` (필수)

워크플로우: 지도를 만들 때는 list_map_examples로 실행 가능한 지도 SDK 예제를 먼저 확보하고, 예제에 없는 기능이 필요할 때 list_sdk_docs → get_sdk_doc으로 정확한 시그니처를 확인합니다. SDK 로더 스크립트는 예제에만 있으므로 레퍼런스만으로는 동작하는 페이지를 만들 수 없습니다.

docId는 클래스/타입 id(inavi.maps.Map, MapOptions)와 메서드 롱네임(inavi.maps.Map#fitBounds)을 모두 받습니다.

SDK 레퍼런스 카테고리 (6개, 총 45개 심볼)

카테고리	심볼 수	포함 심볼
`map`	2	Map, EventPayload
`overlay`	8	Circle, CustomInfoWindow, InfoWindow, Label, Marker, MarkerClusterer, Polygon, Polyline
`control`	3	CompassControl, LogoScaleControl, ZoomControl
`coordinates`	12	LngLat, LngLatBounds, Pixel, PixelBounds, TWLngLat, TWLngLatBounds 및 각 `*Like` 입력 타입
`options`	15	MapOptions, MarkerOptions, CircleOptions 등 `*Options` 타입
`style`	5	ClusterStyle, Color, FillStyle, LabelStyle, LineStyle

Tools

총 6개 도구를 탐색 → 상세 조회 3쌍으로 제공합니다.

list_api_specs — INAVI Maps API 명세를 카테고리별로 탐색합니다.
get_api_spec — operationId로 특정 API의 상세 명세를 조회합니다.
list_map_examples — 지도 SDK 예제 목록을 카테고리별로 탐색합니다.
get_map_example — id로 특정 지도 SDK 예제의 HTML 코드를 조회합니다.
list_sdk_docs — Web JS SDK 심볼(클래스, 옵션/타입 정의)을 카테고리별로 탐색합니다.
get_sdk_doc — docId로 SDK 심볼 하나 또는 단일 메서드의 SDK 레퍼런스를 조회합니다.

문제 해결

MCP 서버가 연결되지 않을 때

Node.js 버전 확인: Node.js 22 이상이 필요합니다 (node -v로 확인)
MCP Host 재시작: 설정 변경 후 반드시 재시작
설정 파일 확인: JSON 문법 오류가 없는지 확인

JSON 파싱 에러

Unexpected token...is not valid JSON

해결 방법:

최신 버전으로 업데이트 (이미 수정된 이슈)
로컬 개발 시 console.log 대신 MCP Logging 사용 (stdout 오염 방지)

더 자세한 문제 해결 방법은 Troubleshooting Guide를 참고하세요.

문서

문서	설명
도구 레퍼런스	모든 도구의 상세 입출력 문서
Claude Desktop 설정	Claude Desktop 설치 및 설정 가이드
Cursor 설정	Cursor IDE 설정 가이드
로컬 개발	소스 코드에서 직접 빌드 및 실행
Troubleshooting	상세 문제 해결 가이드

라이선스

MIT License - 자유롭게 사용, 수정, 배포할 수 있습니다. 자세한 내용은 LICENSE 파일을 참조하세요.

참고 자료

Model Context Protocol - MCP 공식 문서
Claude Desktop - Claude Desktop 다운로드
INAVI Maps API - INAVI Maps API 공식 문서

iNavi Maps Docs

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Reisen, Karten & Wetteri

Häufige Fragen

Alternativen

Maproll

Agro API MCP by usefulapi

FieldClimate MCP by usefulapi

README vom Entwickler

INAVI Maps Docs MCP Server

빠른 시작

방법 1: .mcpb Bundle (Claude Desktop 전용 - 추천)

방법 2: npx (모든 MCP 호스트)

사용 예시

API 탐색 & 코드 생성

지도 시각화

SDK 레퍼런스 조회

조합 활용

사용 가능한 도구

API 명세 도구

지도 SDK 예제 도구

SDK 레퍼런스 도구

Tools

문제 해결

MCP 서버가 연결되지 않을 때

JSON 파싱 에러

문서

라이선스

참고 자료