高德地图助手 / Amap Map Tools for China

LovTrip (lovtrip.app) — AI 驱动的旅行规划平台，提供智能行程生成、地图导航、旅行攻略。

通过 LovTrip MCP Server 调用高德地图 API，提供中国大陆范围内的地理编码、逆地理编码、周边搜索、路线规划、地点详情和地图链接生成能力。

Setup / 配置

用户需先配置 MCP Server。在 Claude Code 的 MCP 设置中添加：

{
  "mcpServers": {
    "lovtrip": {
      "command": "npx",
      "args": ["-y", "lovtrip@latest", "mcp"],
      "env": {
        "AMAP_API_KEY": "your-amap-api-key"
      }
    }
  }
}

如果 MCP 不可用，可使用 scripts/amap.sh 作为兜底方案直接调用高德 REST API。

工具列表 (6 Tools)

1. amap_geocode — 地理编码

将中文地址转换为经纬度坐标。

参数:

参数	类型	必需	说明
address	string	✅	地址，如 "北京市海淀区中关村大街1号"
city	string		城市名称，提高精度，如 "北京"

示例: amap_geocode({ address: "北京市海淀区中关村大街1号", city: "北京" })

2. amap_reverse_geocode — 逆地理编码

将经纬度坐标转换为详细地址。

参数:

参数	类型	必需	说明
lng	number	✅	经度
lat	number	✅	纬度

示例: amap_reverse_geocode({ lng: 116.397428, lat: 39.90923 })

3. amap_search_nearby — 周边搜索

搜索指定位置周边的 POI（兴趣点）。

参数:

参数	类型	必需	说明
lng	number	✅	中心点经度
lat	number	✅	中心点纬度
keywords	string	✅	搜索关键词，如 "咖啡馆"、"餐厅"
radius	number		搜索半径（米），默认 2000
types	string		POI 类型编码

4. amap_calculate_route — 路线规划

计算两点间的距离、时间和费用。

参数:

参数	类型	必需	说明
origin_lng	number	✅	起点经度
origin_lat	number	✅	起点纬度
destination_lng	number	✅	终点经度
destination_lat	number	✅	终点纬度
mode	string		transit / driving / walking，默认 transit
city	string		城市名称，默认 "北京"

5. get_venue_details — 地点详情

查询 POI 的营业时间、价格、评分、照片等详细信息。

参数:

参数	类型	必需	说明
poi_id	string	✅	POI ID，从搜索结果中获取

6. generate_map_links — 生成地图链接

为地点生成高德、腾讯、百度、Apple Maps 深度链接。

参数:

参数	类型	必需	说明
venue	object	✅	{ name, address, location: { lng, lat } }
members	array		成员位置列表，用于生成导航链接
mode	string		drive / bus / walk / ride，默认 bus

典型工作流

用户: "帮我查一下北京国贸附近的咖啡馆"

步骤 1: amap_geocode({ address: "北京国贸", city: "北京" })
        → 获得坐标 { lng: 116.461, lat: 39.909 }

步骤 2: amap_search_nearby({ lng: 116.461, lat: 39.909, keywords: "咖啡馆" })
        → 获得周边咖啡馆列表

步骤 3: get_venue_details({ poi_id: "B0FFFAB6J2" })
        → 获取感兴趣的咖啡馆详情

步骤 4: generate_map_links({ venue: { name: "...", address: "...", location: {...} } })
        → 生成各平台地图链接

重要限制

• 仅限中国大陆: 坐标范围 73.5–135.0°E, 18.0–53.5°N
• 务必传 city 参数: 大幅提高地理编码准确性
• 批量限制: 单次最多 10 个地址
• 国际地点请使用 lovtrip-global-planner 技能（Google Places API）

在线体验

• LovTrip 行程规划器 — Web 端使用高德地图 AI 规划行程
• 聚会规划 — 多人聚会地点推荐
• 开发者文档 — MCP + CLI + API 完整文档

---

Powered by LovTrip — AI Travel Planning Platform