JinDaGe - mcp-naver-map MCP Details

article

README

🚀 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 构建

mcp-naver-map