INAVI Maps API MCP server

INAVI Maps API MCP Server

AI 어시스턴트가 INAVI Maps API를 직접 호출해 장소·주소·경로를 찾고, 결과를 대화 안의 동적 지도로 보여 주는 MCP (Model Context Protocol) 서버입니다.

• 장소·주소 검색 - 상호명·업종·주소로 찾기, 주변 분류 검색, 지오코딩·리버스 지오코딩을 지원합니다.
• 경로 - 자동차(실시간·출발 시각 예측)·도보·킥보드 경로, 경유지 순서 최적화, 거리·시간 행렬을 지원합니다.
• 지도 표시 - 결과를 MCP Apps로 대화 안에 표시하여, 다양한 인터랙션을 지원합니다.

API Key 발급

API Key 발급은 이 곳에서 확인해주세요.

이 서버는 API Key 없이 시작되지 않습니다. 아래 빠른 시작의 INAVI_APPKEY에 발급받은 키를 넣어 주세요.

빠른 시작

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

사전 요구사항: Node.js 22 이상이 설치되어 있어야 합니다 (node -v로 확인).

표준 설정 — 대부분의 MCP 호스트에서 그대로 사용할 수 있습니다. YOURAPIKEY를 발급받은 API Key로 바꾼 뒤 호스트를 재시작하세요.

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

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

Claude Desktop

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

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

Cursor

위 Install in Cursor 버튼을 누르거나, ~/.cursor/mcp.json에 표준 설정을 추가합니다. (공식 가이드) 버튼으로 설치했다면 설정의 YOURAPIKEY를 발급받은 API Key로 바꿔 주세요.

VS Code

위 Install in VS Code 버튼을 누르면 설치할 때 API Key를 입력하는 창이 뜹니다. 키는 설정 파일에 평문으로 남지 않습니다. 또는 다음 명령을 실행합니다. (공식 가이드)

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

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

Claude Code

claude mcp add --transport stdio inavi-maps-api --env INAVI_APPKEY=YOUR_API_KEY -- npx -y @inavi-maps/api-mcp-server

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

Codex

codex mcp add inavi-maps-api --env INAVI_APPKEY=YOUR_API_KEY -- npx -y @inavi-maps/api-mcp-server

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

[mcp_servers.inavi-maps-api]
command = "npx"
args = ["-y", "@inavi-maps/api-mcp-server"]
env = { INAVI_APPKEY = "YOUR_API_KEY" }

Windsurf

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

Shortened. The full README is on GitHub.