wander-agent

pip install wander-agent

安装后马上试试这些——将任意一条复制给你的 AI：

• 🛫 “帮我找一张从纽约飞东京、航空公司不想让我看到的机票。” → OTA 被禁止展示的隐藏城市和分段购票票价
• 🌴 “规划一趟 9 月从迪拜出发、两人同行、预算 $3,000 的 10 天巴厘岛之旅。” → 一次回复涵盖机票、酒店、签证、天气、餐厅、行李清单和逐日行程
• 🛂 “我的两本护照中，哪一本能让我免签进入更多国家？” → 对照 Henley 排名，比较双护照的免签国家
• 💳 “用我的 Amex 积分兑换一张前往欧洲的最佳商务舱机票。” → 跨积分转点合作伙伴寻找积分超值兑换方案

这是什么？

Wander Agent 是一个面向 AI 助手的工具插件（Claude、Cursor、Windsurf 等），为 AI 提供可用的真实旅行数据。

没有这个插件时，问 AI“8 月从纽约飞东京最便宜的机票是多少？”得到的只会是编造的答案。安装插件后，AI 会调用真实数据源——Google Flights、Open-Meteo、美国国务院旅行警示、OpenStreetMap——并提供实际价格、真实天气预报和实时签证要求。

你照常与 AI 对话，其余工作交给 AI。

“帮我规划一趟 9 月从迪拜出发、两人同行、预算 $3,000 的 10 天巴厘岛之旅。” → 一次回复就能提供真实机票、真实酒店、签证要求、天气预报、当地餐厅、行李清单和逐日行程。

它能做什么？

设置（5 分钟）

第 1 步 — 安装 Python

你需要 Python 3.10 或更高版本。检查是否已安装：

python3 --version

还没有？请从 python.org 下载。

第 2 步 — 安装 Wander Agent

从 PyPI 安装（推荐）：

pip install wander-agent

或者使用 uv — 完全无需安装，直接运行：

uvx wander-agent

或者从源代码安装：

git clone https://github.com/VirajMishra1/wander-agent.git
cd wander-agent
pip install -e .

验证是否成功：

wander-agent --help

第 3 步 — 连接到你的 AI

选择你使用的应用：

{
  "mcpServers": {
    "wander-agent": {
      "command": "wander-agent"
    }
  }
}

which wander-agent

{
  "mcpServers": {
    "wander-agent": {
      "command": "/usr/local/bin/wander-agent"
    }
  }
}

claude mcp add wander-agent wander-agent

claude mcp list

{
  "mcpServers": {
    "wander-agent": {
      "command": "wander-agent"
    }
  }
}

{
  "mcpServers": {
    "wander-agent": {
      "command": "wander-agent"
    }
  }
}

{
  "mcpServers": {
    "wander-agent": {
      "command": "wander-agent"
    }
  }
}

{
  "mcpServers": [
    {
      "name": "wander-agent",
      "command": "wander-agent"
    }
  ]
}

{
  "context_servers": {
    "wander-agent": {
      "command": {
        "path": "wander-agent",
        "args": []
      }
    }
  }
}

可选：使用 API 密钥获取更丰富的数据

无需任何 API 密钥即可使用全部功能。如需获取更丰富的数据，可添加以下密钥：

启动 AI 前设置这些密钥：

export FOURSQUARE_API_KEY=your_key_here
export TICKETMASTER_API_KEY=your_key_here

也可以将它们添加到 shell 配置文件（~/.zshrc、~/.bashrc）中，以便永久生效。

全部 75 个工具

✈️ 航班

🏨 酒店

📋 签证与入境

🌤️ 天气

⚠️ 安全与新闻

💰 费用与货币

🗺️ 规划与评分

🍜 美食与夜生活

🌐 智能旅行工具

🎒 旅途实用信息

🏛️ 景点与信息

🧠 旅行者档案

🧳 已保存的行程（跨会话记忆）

行程数据会保存到 ~/.wander_agent/trips.json。每个行程都附带一份包含 8 项内容的预订清单（航班、酒店、签证、保险、地面交通、旅行提示、行李准备、通知银行）。

🔔 票价监控

数据持久化到 ~/.wander_agent/fare_watches.json。为每条监控路线记录基准价格和价格历史。

⚖️ 价值排名

💳 信用卡积分与里程

静态数据集涵盖 20 个忠诚度计划（Chase UR、Amex MR、Citi TYP、Capital One、Bilt、11 家航空公司、4 家酒店集团）、9 张热门信用卡及其奖励类别，以及 10 个精选高价值兑换机会。信用卡组合保存在 ~/.wander_agent/profile.json。

工具排名：实用性 × 独特性

根据实际影响和独特性综合排名——这些功能是 OTA、聊天机器人和其他旅行工具都无法提供的。

数据来源

每个数字的可信度有多高？

大多数结果都带有 data_meta 区块，方便 AI 在你预订前判断数据的可靠程度：

"data_meta": {
  "confidence": "scraped_live",
  "trust_score": 80,
  "trust_label": "Live scrape",
  "meaning": "Scraped from Google Flights just now. Real but can shift minute to minute.",
  "fetched_at": "2026-06-02T18:30:00+00:00",
  "source": "google_flights + kiwi.com"
}

诚实说明与限制

航班价格： Google Flights 抓取器可能会因 Google 更改页面结构而失效。Kiwi 的价格真实且可以预订。两者并行运行；如果其中一个失败，另一个仍会返回结果。

分开购票的风险： find_split_ticket 会显示实际节省金额，但也存在误机风险。如果第一趟航班延误，第二家航空公司不会等待，也不会为你改签。该工具始终会返回完整的风险披露列表。购买涵盖分开购票误机风险的旅行保险。

酒店价格： 所有酒店价格 API 都是付费的。此工具会返回酒店名称和指向 9 个预订网站的链接，你可以在这些网站查看实际价格。此工具不会直接显示价格。

签证数据： 静态快照（2024 年更新）。政策会变化；预订任何行程前，请务必通过回复中的官方链接核实。请勿将此数据作为移民决策的依据。

过境签证数据： 规则以静态数据集的形式编码，涵盖 200 多种组合。可能缺少特殊情况（如享有双边豁免的国籍、近期政策变更）。请务必向航空公司或目的地大使馆核实。

护照实力数据： Henley Index 2024 年快照。排名每年都会变化。根据国籍作出决定前，请通过官方来源确认。

SIM 卡数据： 截至 2024-Q4 的精选快照。价格和套餐经常变化。请将其作为参考；购买前务必核实。

活动： 从 Eventbrite 抓取。对未来 0–60 天内活动的覆盖最佳。更远期的活动可能尚未列出。

旅行警示： 仅限 US State Dept。官方信息变更后 24–48 小时内通过 RSS 更新。

健康数据： 根据 CDC Yellow Book 和 WHO 2024–2025 年建议整理的精选快照。不能替代旅行医学诊所的建议。

地面交通： 使用 Rome2Rio 数据发现路线。实际价格和时刻表必须在预订网站上确认；时间和票价会变化。

积分／里程估值： 基准 cpp 数值为编辑平均值（TPG、NerdWallet、OMAAT）。实际兑换价值取决于具体奖励的可用情况、转点奖励和动态定价。最佳兑换假设存在 saver 级别的可用奖励。信用卡奖励类别反映截至 2025-Q1 的条款；发卡机构会定期调整这些条款。

碳排放计算： 采用 ICAO/DEFRA 2024 年排放因子和标准 RFI 乘数（×1.9）。实际排放量会因机型、载客率和航线而异。请将其作为估算值，而非用于核算的数值。

云端部署（Docker）

随附的 Dockerfile 和 railway.toml 可让你在云端托管此服务，以便从任何设备连接，而不仅限于安装此服务的计算机。

正常本地使用无需进行此操作。 请按照上文的设置说明在本地安装并运行。

如果你想在 Railway 上自托管：

# Push to GitHub, then connect repo to Railway
# Set env vars in Railway dashboard if using optional API keys

服务器会根据 WANDER_TRANSPORT 环境变量，自动从 stdio（本地）切换到 HTTP。

开发

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
python -m pytest tests/ -v

# Count registered tools
grep -c "@mcp.tool()" src/wander_agent/server.py

添加工具：

1. 在 src/wander_agent/tools/your_tool.py 中创建一个异步函数
2. 在 src/wander_agent/server.py 中导入该函数
3. 使用 @mcp.tool() 和一个异步包装函数进行封装
4. 重启 AI 客户端以加载新工具

CI： 每次推送和向 main 提交 PR 时，都会在 Python 3.10/3.11/3.12 上运行测试套件，并验证已注册工具的数量。

发布： 发布 GitHub release 会触发 PyPI 发布工作流（可信发布，无需令牌）。请先更新 pyproject.toml 和 server.json 中的 version。

许可证

MIT

mcp-name: io.github.VirajMishra1/wander-agent