项目简介

Travel Buddy MCP 是一个实现了 Model Context Protocol (MCP) 标准的服务器应用，专门用于为大型语言模型（LLM）客户端提供查询航班和酒店的上下文信息和功能。它集成了 Amadeus API，将复杂的外部服务能力通过MCP工具的形式暴露给LLM，帮助LLM更好地处理旅行相关的查询。

主要功能点

• 作为 MCP 服务器运行，与兼容的 LLM 客户端通信。
• 注册并执行两个核心工具，供LLM调用：
  • 'search_flights': 根据出发地、目的地、出发日期、可选的返回日期以及乘客数，搜索并返回航班信息。
  • 'search_hotels': 根据城市名称、入住日期、退房日期以及乘客数，搜索并返回该城市的酒店信息和报价。
• 通过标准输入/输出 (Stdio) 传输协议与客户端进行交互，易于集成到支持Stdio连接的LLM客户端中。

安装步骤

1. 在本地创建一个目录并进入：

   mkdir travel-buddy && cd travel-buddy
   

2. 克隆仓库：

   git clone https://github.com/royalsanga24/Travel-Buddy-MCP.git
   

3. 进入项目目录：

   cd Travel-Buddy-MCP
   

4. 安装项目依赖：

   npm i
   

5. 编译 TypeScript 代码：

   npm run build
   

6. 在项目根目录创建 '.env' 文件，用于配置 Amadeus API 凭证（请访问 Amadeus 开发者网站注册并获取您的 'CLIENT_ID' 和 'CLIENT_SECRET'）：

   AMADEUS_CLIENT_ID=YOUR_CLIENT_ID
   AMADEUS_CLIENT_SECRET=YOUR_CLIENT_SECRET
   

   请将 'YOUR_CLIENT_ID' 和 'YOUR_CLIENT_SECRET' 替换为您实际的凭证。

服务器配置

此MCP服务器需要通过兼容的MCP客户端（通常是支持MCP功能的LLM客户端）来启动和连接。客户端需要配置服务器的启动信息以便与之建立通信。以下是典型的配置参数，您需要在您的MCP客户端界面或配置文件中填写：

• 服务器名称 ('name'): 'TravelTools'
• 启动命令 ('command'): 'node' (指定运行环境)
• 命令参数 ('args'): '['dist/server.js']' (指定要执行的编译后的服务器文件路径)

注意: 具体配置格式和位置取决于您使用的MCP客户端。请参考您的客户端文档进行配置。

基本使用方法

在支持MCP协议的LLM客户端中完成服务器的安装和配置后，启动该客户端。客户端将自动启动Travel Buddy MCP服务器并通过Stdio连接。LLM即可感知并调用 'search_flights' 和 'search_hotels' 这两个工具。您可以通过与LLM对话，提出需要搜索航班或酒店的需求，LLM将自动调用相应的工具获取信息，并将结果呈现给您。例如，您可以对LLM说：“帮我查一下从纽约到伦敦5月15号出发、5月20号返回的航班。” LLM便可能调用 'search_flights' 工具来完成此任务。