🚀 飞行计划 MCP 服务器

这是一个模型上下文协议（MCP）服务器，借助 fast-flights API 来创建达到旅行代理级别的飞行计划，能为用户提供便捷的航班搜索和旅行计划生成服务。

✨ 主要特性

• 支持单程和往返航班搜索，满足不同出行需求。
• 可依据行程参数生成全面的旅行计划。
• 能够获取机场代码信息。
• 提供常见旅行查询的模板，方便快捷查询。

📦 安装指南

1. 确保已安装 Python 3.10 或更高版本。
2. 安装所需的包：

pip install mcp fast-flights

💻 使用示例

基础用法

运行服务器

可直接运行服务器：

python flight_planner_server.py

集成到 Claude Desktop

1. 安装 Claude Desktop。
2. 创建或编辑你的 Claude Desktop 配置文件：
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. 添加飞行计划器服务器配置：

{
  "mcpServers": {
    "flight-planner": {
      "command": "python",
      "args": [
        "/PATH/TO/flight_planner_server.py"
      ],
      "env": {
        "PYTHONPATH": "/PATH/TO/PROJECT"
      }
    }
  }
}

4. 将 /PATH/TO/ 替换为实际路径。
5. 重启 Claude Desktop。

使用 MCP 检查器

用于测试和开发时，可使用 MCP 检查器：

# 安装检查器
npm install -g @modelcontextprotocol/inspector

# 使用检查器运行你的服务器
npx @modelcontextprotocol/inspector python flight_planner_server.py

高级用法

Claude 示例查询

一旦与 Claude Desktop 集成，你可以询问类似的问题：

• "有什么从 NYC 到 SFO 的航班在 2025-04-15 可用？"
• "你能为我制定一个出差旅行计划吗，从 LAX 到 TPE，时间是 2025-05-01 到 2025-05-08？"
• "帮我查找东京的机场代码。"
• "在夏季假期期间，什么时候从波士顿到伦敦 booking 飞机会是最好的？"

📚 详细文档

可用工具

• search_one_way_flights: 搜索单程航班
• search_round_trip_flights: 搜索往返航班
• create_travel_plan: 生成全面的旅行计划

可用资源

• airport_codes://{query}: 根据搜索查询获取机场代码信息

可用提示

• flight_search_prompt: 搜索航班的模板
• travel_plan_prompt: 创建全面旅行计划的模板

📄 许可证

本项目采用 MIT 许可证。