iNavi

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専用 - おすすめ）

最も簡単なインストール方法です。環境を別途設定することなく、すぐに使用できます。

1. GitHub Releasesから最新の.mcpbファイルをダウンロード
2. ダウンロードした.mcpbファイルをClaude Desktopにドラッグ＆ドロップ（またはダブルクリック）
3. 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"]
    }
  }
}

使用するツールを展開して、設定場所を確認してください。

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

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

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

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

使用例

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リファレンスの参照

AIはWeb JS SDKのクラス・メソッド・オプションの定義を、記憶に頼って推測するのではなく、確認してから回答します。

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

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

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

組み合わせて活用

API仕様、地図SDKのサンプル、SDKリファレンスを組み合わせることで、より複雑な機能を実装できます。

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

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

使用できるツール

このMCPサーバーは、3種類、合計6つのツールを提供します。各ツールのペアは、探索 → 詳細の取得という2段階のワークフローとして設計されています。

API 仕様ツール

INAVI Maps API 仕様（OAS ベース）を AI に提供し、AI が API ドキュメントを直接読まなくても、正しい API 呼び出しコードを作成できるようにします。

ワークフロー： list_api_specs で利用可能な API を探した後、get_api_spec に operationId を渡して、パラメーターやリクエスト／レスポンスのスキーマなどの詳細仕様を取得します。

地図 SDK サンプルツール

SDK ローダーから地図の初期化までを含む、すぐに実行できる地図 SDK サンプル（HTML）を提供します。AI がサンプルのデータ値（座標、ラベルなど）をカスタマイズして、ニーズに合った地図ページを生成します。

ワークフロー： list_map_examples で利用可能なサンプルを探した後、get_map_example に id を渡して、完全な HTML コードを取得します。

SDK リファレンスツール

INAVI Maps Web JS SDK のクラスとオプション／型の定義を提供します。地図 SDK サンプルにないオプション、メソッド、イベントを AI が記憶に頼って推測するのではなく、実際のシグネチャを確認してから作成できるようにします。

ワークフロー： 地図を作成する場合は、まず list_map_examples で実行可能な地図 SDK サンプルを取得し、サンプルにない機能が必要なときに list_sdk_docs → get_sdk_doc で正確なシグネチャを確認します。SDK ローダースクリプトはサンプルにのみ含まれているため、リファレンスだけでは動作するページを作成できません。

docId はクラス／型の ID（inavi.maps.Map、MapOptions）とメソッドのロングネーム（inavi.maps.Map#fitBounds）のどちらにも対応しています。

ツール

合計 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 で 1 つの SDK シンボルまたは単一メソッドの SDK リファレンスを取得します。

トラブルシューティング

MCP サーバーが接続されない場合

1. Node.js のバージョンを確認：Node.js 22 以上が必要です（node -v で確認）
2. MCP Host を再起動：設定の変更後は、必ず再起動してください
3. 設定ファイルを確認：JSON の構文エラーがないことを確認してください

JSON の解析エラー

Unexpected token...is not valid JSON

解決方法：

• 最新バージョンに更新します（修正済みの問題です）
• ローカル開発では console.log の代わりに MCP Logging を使用します（stdout の汚染を防止）

詳しいトラブルシューティングについては、トラブルシューティングガイドを参照してください。

문서

라이선스

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

참고 자료

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