旅行规划插件（美团 + 高德）

演示

下面是插件生成的一个行程网页。我在 Claude 里问“杭州西湖断桥附近住哪”，插件查完美团的价格和高德的路线，把排在前面的几家做成了这个页面：上面是地图，标出目的地和每家酒店；往下是每家的照片、走过去要几分钟和起价。

平时用起来，更像是在和一个熟悉行情的朋友聊天。说一句“下周五去杭州，住杭州东站附近，300 元以内，要大床房”，AI 会先查当天的高铁，再找车站附近的酒店，最后直接给结论：住哪一家，走过去几分钟，大床房多少钱，有没有早餐，能不能免费取消。有时它会再给一个备选，然后附上行程网页的链接。

除了车票和酒店，它还能查市内怎么坐地铁、打车大概要多久、附近有什么吃的，以及某个地方现在堵不堵。它只负责查询和整理，订房和付款还是在美团上自己完成。

它怎么工作

插件是按 MCP 标准写的。MCP（模型上下文协议）可以理解成 AI 和外部工具之间的“通用插座”：按这个标准写好，Claude、Cursor 这些 AI 软件就都能直接接上，调用插件里的十个查询工具。

数据来自两个地方。美团提供车次、航班、酒店和房型价格，但它返回的是一段写给人看的文字，插件要从里面把车次号、时间、价格这些信息挑出来，整理成结构化的数据。高德地图提供坐标、路线和交通时间。美团说“这家酒店 200 元”，高德说“从这里走到车站要 8 分钟”，两边合起来才能判断哪家最合适。插件把价格和交通时间各折算成分数，按偏好加权排序，再替前几家查好房型。AI 拿到的已经是做完功课的材料，只需要用大白话把结论讲出来。

做的过程中踩过不少坑。最早所有地点都默认在北京搜索，结果“上海”被认成了北京的一个小区，后来改成先判断这是城市还是区县，再到对应的城市里找，并给候选地点打相似度分。美团每次查询要十几秒，同时发太多请求还会回一句“忙不过来”，于是加了并发上限、自动重试和缓存。还有一次，我发现 AI 总爱列出一长串酒店和链接，用起来像在逛美团，就把插件的说明改成了“顾问式”：先给结论和理由，只附一个链接。

下载和使用

代码包是 MIT 许可证。高德 Key 和美团 Token 都不随包提供，需要你自己申请。

1. 安装 Python 3.10 或更新版本到 python.org 下载。Windows 安装时勾选“Add python.exe to PATH”。装好后打开 PowerShell，运行 python --version 能看到版本号即可。
2. 解压并进入目录把下载的 travel-planner-mcp.zip 解压到不含中文和空格的路径，例如 D:\travel-planner-mcp，然后在 PowerShell 里进入这个目录。
3. 创建虚拟环境并安装依赖依次运行：

   python -m venv .venv
   .venv\Scripts\activate
   pip install -r requirements.txt

   macOS 或 Linux 把第二行换成 source .venv/bin/activate。下载慢可以加 -i https://pypi.tuna.tsinghua.edu.cn/simple。
4. 申请高德“Web服务”Key登录 高德开放平台控制台，完成个人开发者认证，进入“应用管理 → 我的应用 → 创建新应用”，再点“添加 Key”。服务平台必须选“Web服务”；选成 Web 端 JS API 会报 USERKEY_PLAT_NOMATCH。只在本机使用可以不填 IP 白名单。
5. 申请美团酒旅 Token（可选）登录 美团 Token 页面，按页面说明申请。Token 绑定个人账号，安全级别等同密码。不填也能用高德相关工具。
6. 填写配置把 .env.example 复制为 .env，用记事本打开，至少填写：

   AMAP_API_KEY=your-amap-key
   MEITUAN_HT_TOKEN=your-meituan-token
   MCP_TRANSPORT=stdio

   .env 必须和 server.py 在同一个文件夹。.gitignore 已经排除它。
7. 自检在已激活虚拟环境的终端运行 python server.py --check。看到“高德 OK / 美团 OK”说明 Key 填对了；失败时会说明原因，不会显示 Key。
8. 接入 Claude Desktop打开设置 → 开发者 → 编辑配置，在 claude_desktop_config.json 里加入：

   {
     "mcpServers": {
       "travel": {
         "command": "D:/travel-planner-mcp/.venv/Scripts/python.exe",
         "args": ["D:/travel-planner-mcp/server.py"]
       }
     }
   }

   路径改成你自己的。保存后完全退出 Claude 再打开。
9. 接入 Claude Code在终端运行：

   claude mcp add travel -- D:/travel-planner-mcp/.venv/Scripts/python.exe D:/travel-planner-mcp/server.py

   再输入 /mcp 检查连接状态。
10. 开始使用对 AI 说：“明天从北京去杭州，帮我看看上午的高铁，再在西湖断桥附近找一家 300 元以内的酒店。”查酒店通常要半分钟，因为美团本身就要 10～20 秒。
11. （可选）部署到自己的服务器把 .env 里的 MCP_TRANSPORT 改成 http，设置 MCP_AUTH_TOKEN，需要行程网页时设置 PUBLIC_BASE_URL。参考包里的 deploy/ systemd 和 nginx 示例。客户端连接时带请求头 Authorization: Bearer 你的口令，不要公开服务地址。

常见问题

这是个人学习项目，与美团、高德没有任何官方关系。查询到的酒店、车次、地图等数据的版权归各平台所有。使用时请遵守高德开放平台和美团开放平台的服务条款。Key 和 Token 请只给自己用，商业用途需要另外向平台申请授权。