mcpField
M
MCP Flight Search

MCP Flight Search

本地服务
pypi.org搜索与检索442 周前更新
代码仓库访问官网

关于 MCP Flight Search

供 Claude、Cursor 等 MCP 客户端通过 SerpApi 搜索 Google Flights 的 MCP 服务，支持单程和往返查询，并返回结构化航班信息。

主要功能

  1. 01按 IATA 机场代码搜索航班
  2. 02支持单程和往返查询
  3. 03返回价格、时长、经停和时间
  4. 04检查服务状态与版本

适用场景

  1. 01比较两个机场间的航班选项
  2. 02查询出行日期对应的票价和行程详情

MCP 相关

向 MCP 客户端提供航班搜索和服务状态工具。默认通过 stdio 运行，也支持 Streamable HTTP。

#ai#mcp#serpapi#genai#model-context-protocol#mcp-server#mcp-tools#fligh-search

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "flight-search": {
      "command": "uvx",
      "args": [
        "mcp-flight-search"
      ],
      "env": {
        "SERP_API_KEY": "<SERP_API_KEY>"
      }
    }
  }
}
启动命令uvx mcp-flight-search
需要配置的环境变量
SERP_API_KEY密钥Your SerpApi key (serpapi.com)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypimcp-flight-search0.3.0

工具

2

收录的工具列表 · 更新于 3 周前

参数类型必填说明
originstring是IATA 机场代码，例如 JFK 或 LAX
destinationstring是IATA 机场代码，例如 JFK 或 LAX
return_dateany否往返行程的返程日期，格式为 YYYY-MM-DD
outbound_datestring是出发日期，格式为 YYYY-MM-DD

详细介绍

MCP 航班搜索

一个通过 SerpApi 搜索 Google Flights 的 MCP 服务，适用于 Claude、Cursor 和其他 MCP 客户端。支持按 IATA 机场代码搜索单程和往返航班，并提供价格、时长、中转次数和时间。

CI PyPI

要求

  • Python 3.10 或更高版本（或 uv）
  • 在 SERP_API_KEY 中设置 SerpApi 密钥（serpapi.com 提供免费套餐）

在 MCP 客户端中使用

将其添加到客户端的 MCP 配置中（Claude Desktop、Claude Code、Cursor 等）：

{
  "mcpServers": {
    "flight-search": {
      "command": "uvx",
      "args": ["mcp-flight-search"],
      "env": { "SERP_API_KEY": "your-serpapi-key" }
    }
  }
}

或者使用 pip install mcp-flight-search 安装，并设置 "command": "mcp-flight-search"。

自行运行

export SERP_API_KEY="your-serpapi-key"
mcp-flight-search                                    # stdio (default)
mcp-flight-search --connection_type http --port 3001 # Streamable HTTP at http://127.0.0.1:3001/mcp

LOG_LEVEL=DEBUG 会在标准错误中显示更多详细信息。API 密钥绝不会被记录。

使用 Docker：

docker build -t mcp-flight-search .
docker run -i --rm -e SERP_API_KEY=your-serpapi-key mcp-flight-search

工具

工具功能
search_flights_tool查询两个机场之间的航班。origin、destination：IATA 代码，例如 ATL、LAX。outbound_date：YYYY-MM-DD。return_date（可选）：往返行程的日期，格式为 YYYY-MM-DD。返回结构化结果：航空公司、价格（USD）、时长、中转次数、出发时间、到达时间、舱位等级。
server_status检查服务是否正在运行，并报告其版本。

开发

uv sync
uv run pytest
uv run ruff check .

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。