旅行规划服务

旅行助理MCP服务器

Travel Assistant是一个使用Python构建的模型上下文协议（MCP）服务器 FastMCP。它提供了一个大型语言模型，带有实时工具来计划和预算旅行行程。该助手可以获取实时航班和酒店数据，跟踪旅行预算，并安全地推荐当地地标。

功能和可用工具

此服务器向LLM公开了多种功能(server3.py):

• 航班： check_flight_prices(origin, destination, date, adults) -使用Amadeus API获取实时航班优惠和价格（需要3个字母的IATA城市代码）。
• 酒店：
  • check_hotel(cityCode) -检索可用酒店及其 hotelIds 在一个特定的城市。
  • check_hotel_prices(hotelIds, adults) -检索特定酒店ID的实时客房可用性和定价。
• 预算管理：
  • set_budget(amount) 和 get_budget() -跟踪用户旅行的总消费能力。
  • validate_booking(price) -一个能力围栏，防止人工智能最终确定或提出超过剩余预算的预订。
• 本地信息：
  • recommend_sites(destination) -使用维基百科数据收集地标和观光推荐。

设置和配置

1. 环境变量： 服务器需要实时API密钥才能运行。创建一个 .env 根目录下的文件 my-mcp-server 目录：

   复制

   AMADEUS_API_KEY=your_amadeus_api_key
   AMADEUS_API_SECRET=your_amadeus_api_secret
   

   （注： .env 为了保护您的凭据，文件被标记为无效）。

2. 依赖关系： 确保在虚拟环境中安装了所需的Python包：

   复制

   pip install fastmcp requests python-dotenv amadeus wikipedia
   

与Gemini CLI一起使用

要通过Gemini CLI使用此旅行助手，您需要在系统设置中配置MCP服务器并应用严格的代理提示。

1. 配置MCP服务器： 添加 server3.py 转到您的Gemini CLI settings.json 文件下 mcpServers请确保提供Python虚拟环境可执行文件和服务器脚本的绝对路径：

   复制

   "mcpServers": {
     "travel-server": {
       "command": "C:\\path\\to\\my-mcp-server\\.venv\\Scripts\\python.exe",
       "args": [
         "C:\\path\\to\\my-mcp-server\\server3.py"
       ]
     }
   }
   

2. 系统提示和护栏： 为了获得最佳和最安全的体验，请向AI提供中的系统提示 system_prompt/sys_prompt.md本文件指导LLM如何正确行事（例如，使用IATA代码，将城市代码工具与酒店ID工具本地链接，以及验证预算）。

3. 开始对话： 在终端中运行Gemini CLI：

   复制

   gemini
   

   现在，您可以开始要求助理计划您的旅行了！例如：

   • “我的预算是3000美元。给我找一个下周五从巴黎（标准杆数）到雅典（雅典）的航班，推荐一些酒店！"