Travel Planner MCP Server

旅游规划 MCP 服务器，支持航班搜索、天气查询、汇率查询和行程规划。

功能

• search_flights: 航班搜索，支持深圳/香港出发
• get_weather: 天气查询，包含樱花季预测
• get_exchange_rate: 汇率查询 (CNY/JPY)
• plan_trip: 行程规划建议
• analyze_best_dates: 最佳出行日期分析
• scan_trip_windows: 批量抓取日期窗口，推荐“周四/周五出发、4天左右”最佳组合

安装

npm install
npm run build

配置 (可选)

复制 .env.example 为 .env（可不填）：

cp .env.example .env

• OPENWEATHER_API_KEY: OpenWeatherMap 实时天气（不填则使用内置历史/季节建议）
• EXCHANGE_RATE_API_KEY: Exchange Rate API 实时汇率（不填则自动回退免费汇率接口）

说明：

• scan_trip_windows / search_flights 当前不依赖 SERP_API_KEY。
• 不配置任何 API Key 也能正常用核心行程扫描能力。

不配置 API Keys 也可以使用，会返回有用的建议和参考数据。

在 Claude Code 中使用

在 Claude Code 配置文件中添加：

{
  "mcpServers": {
    "travel-planner": {
      "command": "node",
      "args": ["/Users/oker/github/ai/travel-planner-mcp/dist/index.js"]
    }
  }
}

或者开发模式：

{
  "mcpServers": {
    "travel-planner": {
      "command": "npx",
      "args": ["tsx", "/Users/oker/github/ai/travel-planner-mcp/src/index.ts"]
    }
  }
}

使用示例

配置好后，你可以在 Claude Code 中这样问：

帮我查一下3月份从深圳去东京的航班，想看樱花

3月27-28日从香港出发去东京，帮我分析一下这个时间合适吗

帮我规划一个3天东京行程，预算中等，喜欢美食和动漫

帮我扫描 2026年3月 从深圳/香港出发去东京，周四或周五出发，4天左右，找出最合适时间段

3月东京出行建议

日期	樱花状态	价格水平	推荐指数
3/5-3/6	未开	低	⭐⭐⭐
3/12-3/13	未开	中	⭐⭐⭐⭐
3/19-3/20	初绽	中	⭐⭐⭐⭐⭐
3/26-3/27	盛开	高	⭐⭐⭐⭐⭐

机场代码参考

城市	代码
深圳	SZX
香港	HKG
东京成田	NRT
东京羽田	HND
大阪关西	KIX
札幌	CTS