MCP Naver Maps

🚀 MCP Naver Maps

MCP 可連接至 Naver Maps API 和 Naver Search API，它是一個與 Naver 地圖 API 和搜索 API（本地）進行連接的服務器。

目前，它支持以下 API：

• 地理編碼
• 本地搜索

🚀 快速開始

✅ 前提條件

在開始之前，請確保你已經安裝了以下內容：

• Python：版本 3.13 或更高
• uv：你可以在 此處 找到安裝說明。
• Naver 雲平臺賬戶：你需要 Naver 地圖服務的 API 憑證（客戶端 ID 和客戶端密鑰），可從 Naver 雲平臺控制檯 獲取。
• Naver 開發者賬戶：你需要 Naver 開發者 API 的 API 憑證（客戶端 ID 和客戶端密鑰），可從 Naver 開發者 獲取。

⚙️ 配置

1. 創建 .env 文件：在項目根目錄下創建一個文件。
2. 添加 API 憑證：編輯 .env 文件，添加你的 Naver 地圖 API 憑證和 Naver 開發者 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