项目简介

Amap MCP 服务器是一个专门为大型语言模型（LLM）设计的上下文协议（MCP）服务器，它将高德地图丰富的地理位置服务（如IP定位、地理编码、路径规划、天气查询等）封装成标准化的工具。通过此服务器，LLM客户端可以方便地调用高德地图的各项功能，以获取实时地理信息或执行地理相关操作，从而增强LLM的现实世界交互能力。

主要功能点

高德地图API集成: 提供IP定位、地理/逆地理编码、静态地图生成、天气信息查询、行政区域查询等多种高德地图Web服务API。
POI搜索与路径规划: 支持强大的POI（兴趣点）搜索功能和智能路径规划服务。
坐标转换与输入提示: 提供坐标体系转换以及智能输入提示功能，提升用户体验。
标准化工具接口: 将高德地图的各项服务统一封装为符合MCP规范的工具，方便LLM客户端调用。

安装步骤

获取可执行文件： 访问项目的 GitHub Releases 页面，下载最新版本的 JAR 文件或对应操作系统的原生可执行文件。
（可选）使用容器镜像： 如果您偏好使用Docker，可以直接从 GitHub Container Registry 拉取容器镜像。
设置API Key： 在运行服务器之前，请确保您已在高德开放平台申请了API Key。将此Key设置为环境变量 'AMAP_API_KEY'。

服务器配置

MCP客户端需要以下配置来启动并连接到Amap MCP服务器。请根据您的MCP客户端的配置方式进行设置，通常以JSON格式提供。

启动JAR文件示例配置：

{
  "mcpServers": {
    "amap": {
      "command": "java",
      "args": [
        "-jar",
        "amap-mcp-server.jar"
      ],
      "env": {
        "AMAP_API_KEY": "YOUR_AMAP_API_KEY" // 替换为您实际的高德地图API Key
      }
    }
  }
}

启动Docker容器示例配置：

{
  "mcpServers": {
    "amap": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "AMAP_API_KEY=YOUR_AMAP_API_KEY", // 替换为您实际的高德地图API Key
        "ghcr.io/javaaidev/amap-mcp-server:0.7.0" // 请使用最新的镜像版本
      ]
    }
  }
}

'mcpServers'：定义了要管理的MCP服务器列表。
'amap'：服务器的唯一标识名称，您可以自定义。
'command'：指定启动服务器的命令，例如 'java' 或 'docker'。
'args'：启动命令所需的参数列表，用于指定要运行的JAR包、容器镜像等。
'env'：服务器运行时的环境变量，此处必须设置 'AMAP_API_KEY'。

基本使用方法

MCP客户端启动Amap MCP服务器后，您的LLM应用即可通过标准化的MCP协议调用服务器提供的各种高德地图工具。例如，LLM可以请求服务器执行“天气查询”工具，传入城市名称参数，服务器将调用高德API获取天气信息并返回给LLM。具体工具的调用方式和参数，将遵循MCP协议定义的工具调用规范。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息