INAVI Maps API

INAVI Maps API MCP サーバー

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 ホストでそのまま使用できます。YOUR_API_KEYを発行された API Key に置き換えてから、 ホストを再起動してください。

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

お使いのツールを展開して、設定場所をご確認ください。

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

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

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

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

地図は MCP Apps に対応したホストでのみ表示されます。 Claude Desktop で動作を確認しています。 対応していないホストでもツールの呼び出しと応答は通常どおり動作しますが、地図は表示されません。

使用例

結果を地図で見たい場合は、「地図に表示して」とあわせて依頼してください。

Claude Desktop と ChatGPT App は、標準搭載ツールとして Google マップに対応しています。プロンプトの最後にINAVI MCPを使ってと付けることをおすすめします。

場所・住所

판교역 주변 스타벅스 찾아서 지도에 보여줘. INAVI MCP를 사용해줘

판교역 반경 500m 안의 편의점 전부 지도에 보여줘. INAVI MCP를 사용해줘

경기도 성남시 분당구 판교역로 240 좌표 알려줘. INAVI MCP를 사용해줘

127.110750, 37.402159 여기 주소가 어디야? INAVI MCP를 사용해줘

ルート

판교역에서 강남역까지 자동차 경로 알려줘. 지도에 보여줘. INAVI MCP를 사용해줘

내일 아침 8시에 판교역에서 강남역으로 출발하면 얼마나 걸려? 8시 반이랑 비교해줘. INAVI MCP를 사용해줘

판교역에서 판교테크노밸리까지 걸어가는 길 알려줘. 계단은 피하고 싶어. INAVI MCP를 사용해줘

판교역에서 출발해서 서현역, 정자역, 미금역을 들르는 가장 짧은 순서 알려줘. INAVI MCP를 사용해줘

판교역, 서현역, 정자역 사이 거리랑 시간 비교해줘. INAVI MCP를 사용해줘

利用可能なツール

INAVI Maps API を呼び出す11 個のツールを提供します。lookup_category_codeを除く 10 個のツールでは、 地図を表示できます。

地図でできること

地図は結果を表示するだけではありません。会話の流れを途切れさせないよう、オプション値を変更して MCP Apps 内でツールを呼び出せます。

ルート作成では、リストまたは地図から出発地・到着地を選ぶと、ルート検索の質問が会話の入力欄に入力されます。 送信前に文面を確認できます。リストの会話へボタンも同様に、その場所を会話に渡します。

すべての地図で地図タイプ（標準・航空写真・ハイブリッド・地形）とライト・ダークテーマを切り替えられ、 MCP ホストが対応していれば全画面で表示できます。

環境変数

トラブルシューティング

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

1. API Key の確認：サーバー設定のenvにINAVI_APPKEYがあるか確認してください。設定されていない場合、サーバーは起動しません
2. Node.js のバージョン確認：Node.js 22 以上が必要です（node -vで確認）
3. 設定ファイルの確認：JSON の構文エラーがないか確認してください
4. MCP Host の再起動：設定変更後は、必ず完全に終了してから再度起動してください

その他の症状

ライセンス

MIT License - 自由に使用、変更、配布できます。詳しくはLICENSEファイルを参照してください。

参考資料

• Model Context Protocol - MCP 公式ドキュメント
• MCP Apps - 会話内に画面を描画する MCP 拡張機能
• Claude Desktop - Claude Desktop のダウンロード
• INAVI Maps API - INAVI Maps API 公式ドキュメント