Mcp Naver Maps

MCP Naver Maps

この MCP は、Naver Maps API と Naver Search API に接続します。네이버 지도 API와 검색 API에 (로컬) 연결하는 MCP 서버.

現在、以下の API をサポートしています。

• ジオコーディング
• ローカル検索

前提条件

開始する前に、以下がインストールされていることを確認してください。

• Python： バージョン 3.13 以降
• uv： インストール手順はこちらをご覧ください。
• Naver Cloud Platform アカウント： Naver Maps サービスの API 認証情報（Client ID と Client Secret）が必要です。Naver Cloud Platform のコンソールから取得できます。
• Naver Develoeprs アカウント： Naver Developers API の API 認証情報（Client ID と Client Secret）が必要です。Naver Developersから取得できます。

設定

1. .env ファイルを作成する： プロジェクトのルートにファイルを作成します。

2. API 認証情報を追加する： .env ファイルを編集し、Naver Maps API と Naver Developers API の認証情報を追加します。

   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"
   

   src/mcp_naver_maps/naver_maps_client.py を確認し、必要な環境変数名が正確であることを確認してください。

MCP の実行

1. 依存関係を同期する： ターミナルでプロジェクトのルートディレクトリに移動し、次のコマンドを実行します。仮想環境が存在しない場合は作成し、pyproject.toml で指定されているすべての依存関係をインストールします。

   uv sync
   

2. 実行： uv を使用して MCP サーバーを実行できます。

   uv run src/mcp_naver_maps
   

   開発時は、次のように実行します。

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