MCP 航班搜索

这是一个使用模型上下文协议（MCP）构建的航班搜索服务。该服务展示了如何实现MCP工具以提供航班搜索功能。

什么是模型上下文协议？

模型上下文协议 (MCP) 是由Anthropic开发的一个标准，它通过定义工具描述、调用和响应的结构化格式来使AI模型能够使用工具。这个项目实现了可以被Claude和其他兼容MCP的模型使用的MCP工具。

安装

# Install from PyPI
pip install mcp-flight-search

# Or install from the project directory (development mode)
pip install -e .

使用方法

启动MCP服务器：

# Using the command-line entry point
mcp-flight-search --connection_type http

# Or run directly
python main.py --connection_type http

您也可以指定自定义端口：

python main.py --connection_type http --port 5000

环境变量

将SerpAPI密钥设置为环境变量：

export SERP_API_KEY="your-api-key-here"

特性

• 符合MCP标准的航班搜索功能工具
• 与SerpAPI Google Flights集成
• 支持单程和往返航班
• 丰富的日志记录，具有结构化输出
• 模块化、易于维护的代码结构

MCP 工具

此包提供了以下模型上下文协议工具：

• search_flights_tool：根据参数在机场之间搜索航班：

  • origin：出发机场代码（例如ATL, JFK）
  • destination：到达机场代码（例如LAX, ORD）
  • outbound_date：出发日期（YYYY-MM-DD）
  • return_date：可选的返程日期（对于往返行程，格式为YYYY-MM-DD）

• server_status：检查MCP服务器是否正在运行

项目结构

mcp-flight-search/
├── mcp_flight_search/
│   ├── __init__.py              # Package initialization and exports
│   ├── config.py                # Configuration variables (API keys)
│   ├── models/
│   │   ├── __init__.py          # Models package init
│   │   └── schemas.py           # Pydantic models (FlightInfo)
│   ├── services/
│   │   ├── __init__.py          # Services package init
│   │   ├── search_service.py    # Main flight search logic
│   │   └── serpapi_client.py    # SerpAPI client wrapper
│   ├── utils/
│   │   ├── __init__.py          # Utils package init
│   │   └── logging.py           # Logging configuration
│   └── server.py                # MCP server setup and tool registration
├── main.py                      # Main entry point
├── pyproject.toml               # Python packaging configuration
├── LICENSE                      # MIT License
└── README.md                    # Project documentation

作者

欲了解更多关于AI/ML和生成式AI的文章，请在Medium上关注我: https://medium.com/@arjun-prabhulal

许可证

本项目采用MIT许可证发布 - 详情请参阅LICENSE文件。