MCP Naver Maps

🚀 MCP Naver Maps

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

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

• Geocoding
• Local saerch

🚀 クイックスタート

✨ 事前準備

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

• Python：バージョン3.13以上
• uv：インストール手順は こちら で確認できます。
• Naver Cloud Platformアカウント：Naver MapsサービスのAPI資格情報（クライアントIDとクライアントシークレット）が必要です。これらは Naver Cloud Platformコンソール から取得できます。
• Naver Develoeprsアカウント：Naver Developers APIのAPI資格情報（クライアントIDとクライアントシークレット）が必要です。これらは 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 を確認してください。

実行

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