MCP Naver Map

🚀 MCP - NAVER 地圖

MCP - NAVER 地圖是一個集成了 Naver Cloud 的 Geolocation API 和 Directions15 API 的 MCP 服務器，它能夠提供基於 IP 的位置查找以及路線規劃功能，為用戶的位置查詢和出行規劃提供便利。

🚀 快速開始

先決條件

• Python 3.12+
• uv 包管理器
• 已激活的 Naver Cloud Platform 賬戶及以下服務：
  • Geolocation API
  • Directions15 API
• 兼容 MCP 的客戶端（例如 Claude for Desktop）

1. 克隆與設置

# 克隆倉庫
git clone https://github.com/yourusername/mcp-naver-location.git
cd mcp-naver-map

# 安裝依賴項
uv sync

創建一個包含憑證的 .env 文件：

NAVER_ACCESS_KEY_ID=你的訪問密鑰 ID
NAVER_SECRET_KEY=你的秘密密鑰
MAP_CLIENT_ID=你的地圖客戶端 ID
MAP_CLIENT_SECRET=你的地圖客戶端密碼

2. 配置 MCP 客戶端

在你的 MCP 客戶端中註冊此服務器（例如，Claude for Desktop）。

編輯 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "mcp-naver-location": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-naver-location",
        "run",
        "server"
      ]
    }
  }
}

3. 啟動 Claude

⚠️ 重要提示

必須從終端啟動 Claude 才能與 MCP 服務器建立正確連接。

# macOS:
/Applications/Claude.app/Contents/MacOS/Claude

# Windows:
"C:\Program Files\Claude\Claude.exe"

✨ 主要特性

📍 基於 IP 的位置查找

通過提供一個 IP 地址來獲取近似位置。

"我現在在哪裡（IP: xxx.xxx.xxx.xxx）？"
→ 📍 返回提供的 IP 對應的緯度和經度

• 由 NCP Geolocation API 提供支持
• 需要手動輸入 IP

🛣️ 路線規劃

獲取兩個指定點之間的最優駕駛路線。

"如何從市政廳到首爾站？"
→ 🛣️ 返回路線指引

• 由 NCP Directions15 API 提供支持

📄 許可證

• 此項目根據 MIT License 發佈。有關詳細信息，請參閱 LICENSE 文件。
• 使用 Model Context Protocol 構建