使用说明

项目简介

Globe Genie Travel MCP Servers 是基于 Model Context Protocol (MCP) 构建的后端服务，旨在为 AI 旅行规划应用提供必要的上下文信息和功能。它包含两个独立的 MCP 服务器：Travel Services 和 Destination Services，分别提供航班和酒店搜索，以及天气和本地活动查询工具。这些服务器可以与支持 MCP 协议的 LLM 客户端（如智能体应用）集成，实现强大的旅行规划能力。

主要功能点

航班和酒店搜索工具: 通过调用 Amadeus 和 SerpAPI 接口，提供实时的航班和酒店搜索功能。
天气和本地活动查询工具: 利用 SerpAPI 接口，提供城市天气预报和本地活动信息查询。
MCP 服务器实现: 基于 'fastmcp' 库构建，实现了标准的 MCP 协议，支持 SSE (Server-Sent Events) 传输协议。
工具注册和发现: MCP 服务器自动注册和声明可用工具，客户端可以动态发现并调用这些工具。
微服务架构: 采用微服务架构，功能模块化，易于扩展和维护。

安装步骤

克隆仓库

git clone https://github.com/gandhiraketla/travel-agent-mcp.git
cd travel-agent-mcp

进入 'backend' 目录
```
cd backend
```

创建虚拟环境 (推荐)

python -m venv venv
# 激活虚拟环境
# Windows: venv\Scripts\activate
# macOS/Linux: source venv/bin/activate

安装依赖

pip install -r requirements.txt

配置环境变量

在 'backend' 目录下创建 '.env' 文件，并填入API密钥：

AMADEUS_CLIENT_ID=your_amadeus_client_id
AMADEUS_CLIENT_SECRET=your_amadeus_client_secret
SERPAPI_KEY=your_serpapi_key
DEEPSEEK_API_KEY=your_deepseek_api_key

(请前往 Amadeus Developer Portal, SerpAPI, Deepseek AI 官网获取API密钥)

服务器配置

MCP 客户端需要配置以下信息以连接到 MCP 服务器。以下是针对 Travel Services 和 Destination Services 两个 MCP 服务器的配置示例 (JSON 格式)：

Travel Services MCP Server 配置

{
  "server_name": "TravelServices",  // 服务器名称，用于客户端识别
  "command": "python",             // 启动服务器的命令
  "args": ["backend/mcp/travel_mcp_server.py"], // 启动命令的参数，指向服务器脚本
  "transport": "sse",            // 使用 SSE 传输协议
  "url": "http://localhost:8000/sse" // 服务器 SSE 端点 URL
}

Destination Services MCP Server 配置

{
  "server_name": "DestinationServices", // 服务器名称，用于客户端识别
  "command": "python",                // 启动服务器的命令
  "args": ["backend/mcp/destination_service_mcp.py"], // 启动命令的参数，指向服务器脚本
  "transport": "sse",               // 使用 SSE 传输协议
  "url": "http://localhost:5000/sse"  // 服务器 SSE 端点 URL
}

(请注意：'server_name' 供客户端识别，'command' 和 'args' 用于启动服务器进程，'transport' 指定通信协议，'url' 是客户端连接的服务器地址。)

基本使用方法

启动 MCP 服务器
- 打开两个终端窗口，分别进入 'backend/mcp' 目录。
- 在一个终端窗口运行 'python travel_mcp_server.py' 启动 Travel Services MCP 服务器。
- 在另一个终端窗口运行 'python destination_service_mcp.py' 启动 Destination Services MCP 服务器。
配置 MCP 客户端
- 在您的 MCP 客户端应用中，根据上述 “服务器配置” 信息，配置连接到 Travel Services 和 Destination Services 服务器。
客户端调用工具
- 客户端连接成功后，可以发现并调用服务器提供的工具，例如 'get_flights' (航班搜索), 'get_hotels' (酒店搜索), 'get_weather' (天气查询), 'get_local_events' (本地活动查询) 等。
- 具体工具的使用方法和参数，请参考代码中 '@mcp.tool()' 注释的函数说明。

关键词