航班搜索服务

一个基于Google Flights数据的航班搜索服务器,提供全面的航班信息和价格分析。

  • by chaosisnotrandomitisrhythmic
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 chaosisnotrandomitisrhythmic/flights-mcp

使用说明

mcp航班

用于搜索航班的MCP服务器 谷歌航班 数据通过 SerpAPI.

内置于 FastMCP 供与...一起使用 克劳德代码Claude Desktop或任何兼容MCP的客户端。

为什么

大多数航班MCP服务器对航空公司的覆盖不完整,缺少瑞安航空、易捷航空或威兹航空等低成本航空公司。此服务器使用Google Flights(通过SerpAPI)聚合所有航空公司,为您提供与浏览器中相同的结果。

特性

  • 使用完整的谷歌航班数据搜索单程和往返航班
  • 按停靠站、客舱等级、价格和分拣顺序过滤
  • 从航空公司和旅行社获取预订链接
  • 价格洞察(价格水平、典型区间、价格历史)
  • 包括所有航空公司(瑞安航空、易捷航空、伊比利亚航空、汉莎航空等)

工具

mcp_search_flights

搜索特定路线和日期的航班。

参数 类型 默认值 说明
departure str 必填 出发机场IATA代码(例如。 MAD)
arrival str 必填 到达机场IATA代码(例如。 BER)
date str 必填 出发日期 YYYY-MM-DD
return_date str None 往返的返回日期
passengers int 1 成年乘客人数
stops int None 1=不间断, 2=最大1次停车, 3=最多2站
travel_class int 1 1=经济, 2=保费, 3=商业, 4=第一
sort_by int 1 1=顶部, 2=价格, 3=出发, 4=到达, 5=持续时间
currency str EUR ISO货币代码
max_price int None 最高价格过滤器

mcp_get_booking_options

使用其获取特定航班的预订链接 booking_token 从搜索结果中。

参数 类型 默认值 说明
booking_token str 必填 航班搜索结果中的令牌
currency str EUR ISO货币代码

设置

1.获取SerpAPI密钥

注册地址: 蛇网 并获取您的API密钥。免费套餐包括每月100次搜索。

2.添加到克劳德代码

claude mcp add flights \
  -e SERPAPI_API_KEY=your_key_here \
  -- uv --directory /path/to/flights-mcp run flights-mcp

或手动添加到 ~/.claude.json:

{
  "mcpServers": {
    "flights": {
      "type": "stdio",
      "command": "uv",
      "args": ["--directory", "/path/to/flights-mcp", "run", "flights-mcp"],
      "env": {
        "SERPAPI_API_KEY": "your_key_here"
      }
    }
  }
}

3.重新启动克劳德代码

重新启动后,服务器将可用。试试:“搜索3月19日从马德里到柏林的直达航班”。

发展

git clone https://github.com/chaosisnotrandomitisrhythmic/flights-mcp.git
cd flights-mcp
uv sync
SERPAPI_API_KEY=your_key uv run flights-mcp

建筑

src/flights_mcp/
├── __init__.py    # Exports mcp instance and run_server
├── server.py      # FastMCP server setup and tool definitions
└── tools.py       # Pure business logic (no MCP awareness)
  • tools.py --调用SerpAPI并返回字典的纯Python函数。无MCP依赖性。易于独立测试。
  • server.py --薄型 @mcp.tool() 将结果序列化为JSON的包装器。定义MCP接口。

许可证

麻省理工学院