旅行助理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) -使用维基百科数据收集地标和观光推荐。
设置和配置
- 环境变量:
服务器需要实时API密钥才能运行。创建一个 .env 根目录下的文件 my-mcp-server 目录:
AMADEUS_API_KEY=your_amadeus_api_key
AMADEUS_API_SECRET=your_amadeus_api_secret*(注: .env 为了保护您的凭据,文件被标记为无效)。*
- 依赖关系:
确保在虚拟环境中安装了所需的Python包:
pip install fastmcp requests python-dotenv amadeus wikipedia与Gemini CLI一起使用
要通过Gemini CLI使用此旅行助手,您需要在系统设置中配置MCP服务器并应用严格的代理提示。
- 配置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"
]
}
}- 系统提示和护栏:
为了获得最佳和最安全的体验,请向AI提供中的系统提示 system_prompt/sys_prompt.md本文件指导LLM如何正确行事(例如,使用IATA代码,将城市代码工具与酒店ID工具本地链接,以及验证预算)。
- 开始对话:
在终端中运行Gemini CLI:
gemini现在,您可以开始要求助理计划您的旅行了!例如:
- *“我的预算是3000美元。给我找一个下周五从巴黎(标准杆数)到雅典(雅典)的航班,推荐一些酒店!"*
