Naver Map MCP

导航地图MCP服务器

这是一个MCP服务器，它利用Naver Map API（地理编码、反向地理编码、方向5、方向15）与Claude Desktop一起使用。

备注：此MCP服务器不支持需要客户端渲染的API（动态映射、静态映射）。

特性

• 使用导航地图地理编码API进行地址搜索（检索地址信息和坐标）
• 使用导航地图反向地理编码API将坐标转换为地址
• 使用导航地图方向5 API进行路线搜索（最多5个航路点）
• 使用导航地图方向15 API进行路线搜索（最多15个航路点）
• 与Claude Desktop集成，在对话中使用所有这些功能

安装说明

1. 在Naver开发者中心注册应用程序(https://developers.naver.com)或Naver云平台，获取客户端ID和密码。

1. 您可以使用以下三种方法之一设置API密钥：

方法1：在Claude Desktop配置中直接作为命令行参数传递

打开 %AppData%\Claude\claude_desktop_config.json 文件（Windows）或 ~/Library/Application Support/Claude/claude_desktop_config.json 文件（Mac），并按如下方式修改：

{
  "mcpServers": {
    "navermap-mcp": {
      "command": "node",
      "args": [
        "installation_path/dist/index.js",
        "--clientId=YOUR_CLIENT_ID",
        "--clientSecret=YOUR_CLIENT_SECRET"
      ]
    }
  }
}

方法2：设置为环境变量

您可以使用系统环境变量设置API键。当在多个脚本中使用相同的键时，这很有用。

对于Windows，在命令提示符中：

set NAVER_CLIENT_ID=YOUR_CLIENT_ID
set NAVER_CLIENT_SECRET=YOUR_CLIENT_SECRET

对于Mac/Linux，在终端中：

export NAVER_CLIENT_ID=YOUR_CLIENT_ID
export NAVER_CLIENT_SECRET=YOUR_CLIENT_SECRET

然后按如下方式设置Claude Desktop配置文件：

{
  "mcpServers": {
    "navermap-mcp": {
      "command": "node",
      "args": ["installation_path/dist/index.js"],
      "env": {
        "NAVER_CLIENT_ID": "YOUR_CLIENT_ID",
        "NAVER_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

方法3：创建启动脚本

您可以创建启动脚本来设置环境变量并运行MCP服务器。

Windows启动脚本示例(start-mcp.bat):

@echo off
set NAVER_CLIENT_ID=YOUR_CLIENT_ID
set NAVER_CLIENT_SECRET=YOUR_CLIENT_SECRET
node installation_path/dist/index.js

Mac/Linux的启动脚本示例(start-mcp.sh):

#!/bin/bash
export NAVER_CLIENT_ID=YOUR_CLIENT_ID
export NAVER_CLIENT_SECRET=YOUR_CLIENT_SECRET
node installation_path/dist/index.js

然后按如下方式设置Claude Desktop配置文件：

{
  "mcpServers": {
    "navermap-mcp": {
      "command": "installation_path/start-mcp.bat" // Windows
      // or
      // "command": "installation_path/start-mcp.sh"  // Mac/Linux
    }
  }
}

对于Mac/Linux，您需要授予启动脚本执行权限：

chmod +x installation_path/start-mcp.sh

1. 重新启动克劳德桌面。

如何使用

您可以在与Claude对话期间使用以下格式请求服务：

地址搜索（地理编码API）

• “搜索首尔江南区德黑兰路”
• “釜山海云台区的坐标是多少？”
• “搜索大田市鱼城区的大韩路”

将坐标转换为地址（反向地理编码API）

• “告诉我坐标127.1058342,37.3597080处的地址”
• “纬度37.5666103，经度126.9783882在哪里？”
• “显示这些坐标的地址信息（129.075986，35179470）”

路线搜索（API指令5/15）

• “告诉我如何从首尔到釜山”
• “搜索从起点（127.1058342,37.3597080）到目的地（129.075986,35.179470）的路线”
• “找一条去首尔的路线→大田→Daegu→釜山”
• “找到从江南站到光化门的最佳路线”

开发环境

• Node.js
• TypeScript
• MCP-SDK
• 导航地图API（地理编码、反向地理编码、方向5、方向15）

许可证

• 麻省理工学院