mcp-flight-search
MCP 航班搜索
使用模型上下文协议 (MCP) 构建的航班搜索服务。此服务演示了如何实现 MCP 工具以实现航班搜索功能。
什么是模型上下文协议?
模型上下文协议 (MCP) 是由 Anthropic 开发的一项标准,它通过定义工具描述、调用和响应的结构化格式,使 AI 模型能够使用工具。该项目实现了可供 Claude 和其他兼容 MCP 的模型使用的 MCP 工具。
Related MCP server: Google-Flights-MCP-Server
安装
# 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 文件。
Available Tools
2 toolssearch_flights_toolSearch flightsARead-only
Search Google Flights for one-way or round-trip flights between two airports.
Inputs: origin (required), destination (required), outbound_date (required), return_date. Returns: result
server_statusServer statusARead-only
Check that the flight search server is running.
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools serve entirely distinct purposes: one performs a flight search, the other reports server health. There is no plausible way to confuse them, and the descriptions make the boundary explicit.
Both names are snake_case, but the convention is inconsistent: 'search_flights_tool' uses a redundant '_tool' suffix and a verb_verb_noun shape, while 'server_status' is a plain noun phrase. Readable, but the pattern isn't predictable.
Two tools is thin for a flight search server; the health-check tool arguably doesn't earn a slot as a first-class tool. It's a borderline-surface rather than an extreme mismatch.
Flight search is covered, but obvious adjacent operations are absent: airport/location lookup, date-range or fare-calendar search, multi-city itineraries, and filtering/sorting of results. An agent can do the core task but will hit dead ends on common follow-ups.
Maintenance
Related MCP Connectors
Search and compare flight offers through a cache-aware Streamable HTTP MCP server for AI agents.
Flight search MCP server providing search, pagination, and itinerary details for AI assistants.
Geo-based flight search MCP server. Find more flights between any two places on earth
Live flight prices and working booking links for AI agents and travel apps.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that connects to Amadeus API, enabling AI assistants to search flights, analyze prices, find best travel deals, and plan multi-city trips.18 npm6MIT
- AlicenseNot gradedqualityNot gradedmaintenanceThis MCP server allows an AI assistants to search for flight information online using Google Flights. It can find flights for specific dates or search through a range of dates to find all options or just the cheapest ones available.27-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables flight searching, booking, and payment processing. It also provides access to resources like user profiles, pricing rules, and company travel policies.MIT
- FlicenseNot gradedqualityDmaintenanceAn interactive travel planning server that integrates flight searching, weather forecasting, and route calculation through external APIs like Amadeus and OpenWeather. It uses the Model Context Protocol to enable AI assistants to autonomously manage travel logistics and discover local services.-