Travel Planner MCP Server 使用说明

项目简介

Travel Planner MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在为大型语言模型 (LLM) 提供旅行规划能力。通过此服务器，LLM 可以调用各种工具来完成旅行相关的任务，例如创建旅行行程、搜索旅游景点、查询交通方案和住宿信息等。

主要功能点

行程规划: 根据用户指定的出发地、目的地、日期、预算和偏好，为用户创建个性化的旅行行程。
行程优化: 根据用户指定的优化标准（如时间、成本等），优化现有的旅行行程。
景点搜索: 在指定地点搜索旅游景点和兴趣点，并可指定搜索半径和景点类别。
交通方案查询: 查询出发地和目的地之间的交通方案，包括交通方式和预计时间等。
住宿查询: 在指定地点搜索住宿选项，并可指定入住和退房日期、预算等。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。
使用 npx 运行 (推荐): 在命令行中，你可以直接使用 'npx' 命令来运行此 MCP 服务器，无需全局安装。
```
npx @gongrzhe/server-travelplanner-mcp
```

手动安装 (全局安装): 你也可以选择全局安装此包，然后直接运行。

npm install -g @gongrzhe/server-travelplanner-mcp

安装完成后，运行命令：

@gongrzhe/server-travelplanner-mcp

配置 Google Maps API 密钥 (必需): 此服务器依赖 Google Maps API 来提供地理位置服务。你需要在 Google Cloud Platform 上创建一个项目并启用以下 API：
- Places API
- Directions API
- Geocoding API
- Time Zone API
获取 API 密钥后，你需要将其设置为环境变量 'GOOGLE_MAPS_API_KEY'。例如，在运行命令前设置环境变量：
```
GOOGLE_MAPS_API_KEY=YOUR_API_KEY npx @gongrzhe/server-travelplanner-mcp
```
或者
```
GOOGLE_MAPS_API_KEY=YOUR_API_KEY @gongrzhe/server-travelplanner-mcp
```
请将 'YOUR_API_KEY' 替换为你自己的 Google Maps API 密钥。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude Desktop），你需要在客户端的配置文件中添加以下 JSON 配置。以 Claude Desktop 为例，你需要编辑 'claude_desktop_config.json' 文件，并在 'mcpServers' 部分添加以下配置：

{
  "mcpServers": {
    "travel-planner": {  // 服务器名称，可以自定义
      "command": "npx",  // 启动服务器的命令，这里使用 npx
      "args": ["@gongrzhe/server-travelplanner-mcp"], // 启动命令的参数，指定要运行的 npm 包
      "env": {  // 环境变量
        "GOOGLE_MAPS_API_KEY": "YOUR_GOOGLE_MAPS_API_KEY" // Google Maps API 密钥，请替换为你的密钥
      }
    }
  }
}

请务必将 'YOUR_GOOGLE_MAPS_API_KEY' 替换为你自己的 Google Maps API 密钥。

基本使用方法

启动 Travel Planner MCP Server。
配置 MCP 客户端（如 Claude Desktop）连接到该服务器。
在 MCP 客户端中，你可以指示 LLM 使用 'travel-planner' 服务器提供的工具来执行旅行规划相关的任务。例如，你可以指示 LLM 调用 'create_itinerary' 工具来创建一个旅行行程，或者调用 'search_attractions' 工具来搜索景点。

注意: 此服务器目前仅实现了工具的基本框架，实际的 Google Maps API 调用和数据处理逻辑可能需要进一步完善。

关键词