本项目是一个 Model Context Protocol (MCP) 服务器实现，它将 HERE 地图平台的功能（如地理编码、路线规划、地点搜索、交通信息等）封装成 MCP 工具，使得支持 MCP 的大语言模型（LLM）客户端可以直接调用这些功能，获取地理位置相关的实时上下文信息或执行相关操作。

主要功能点

• 地理编码 (Geocoding): 将地址转换为经纬度坐标。
• 逆地理编码 (Reverse Geocoding): 将经纬度坐标转换为易读的地址。
• 地点搜索 (Places Search): 搜索指定位置附近的兴趣点（如餐厅、ATM 等）。
• 路线规划 (Routing): 计算两个地点之间的导航路线。
• 交通信息 (Traffic Information): 获取指定区域的实时交通事件信息。
• 地图显示 (Display Map): 生成一个指定位置和缩放级别的地图图片。

安装步骤

1. 克隆仓库:

   git clone https://github.com/limingchina/heremaps-mcp-server.git
   

2. 安装 Node.js 和 npm: 访问 Node.js 官方网站 下载并安装最新版本。
3. 安装项目依赖:

   cd heremaps-mcp-server/src/node
   npm install
   

4. 获取 HERE Maps API Key: 按照 HERE 认证指南 获取你的 API Key。

服务器配置 (供 MCP 客户端使用)

MCP 服务器通常由 MCP 客户端根据配置启动。你需要将本服务器的启动信息添加到你使用的 MCP 客户端的配置中。配置信息通常包括服务器的唯一名称、启动服务器的命令、命令所需的参数以及环境变量（用于传递 API Key）。

例如，配置中会包含：

• 'server name': 给服务器一个易于识别的名称，如 'here-maps'。
• 'command': 启动服务器的可执行文件，本项目中使用 'npx'。
• 'args': 'npx' 命令的参数，指向服务器代码的路径，如 '-y /你的项目本地路径/src/node'。
• 'env': 环境变量，用于传递 'HERE_MAPS_API_KEY'，确保服务器能访问 HERE Maps API。

完成配置后，可能需要重启 MCP 客户端以使设置生效。

基本使用方法

配置完成后，支持 MCP 的 LLM 客户端在处理与地图相关的用户请求时，将能够识别并调用此服务器提供的工具。用户可以通过自然语言提出请求，例如：

• “在柏林市中心找一些法国餐厅。” (LLM 可能会先调用地理编码，然后调用地点搜索工具)
• “从 Reinickendorf 到 Mitte 的路线怎么走？” (LLM 可能会调用两次地理编码，然后调用路线规划工具)
• “巴黎市中心的交通怎么样？” (LLM 可能会调用地理编码，然后调用交通信息工具)
• “显示巴黎市中心的地图。” (LLM 可能会调用地理编码，然后调用地图显示工具)

LLM 会自动解析用户请求，确定需要调用的工具及其参数，并将请求发送给 MCP 服务器。服务器执行相应的 HERE Maps API 调用，并将结果返回给 LLM，LLM 再将结果整合到对用户的回复中。