LumbreTravel MCP Server 使用说明

项目简介

LumbreTravel MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它充当 LLM 客户端（如 Claude Desktop）和 LumbreTravel 旅行平台 API 之间的桥梁。通过这个 MCP 服务器，用户可以使用自然语言指令，让 LLM 客户端调用 LumbreTravel API 的各种功能，实现旅行程序的创建、查询、修改以及相关旅行资源的管理。

主要功能点

旅行程序管理: 创建、更新、删除和查询旅行程序，包括按名称、日期范围检索程序。
活动管理: 添加、更新和删除旅行活动，支持关联服务、酒店、导游、车辆和乘客。
乘客管理: 查询、创建、更新和删除乘客信息，支持按姓名、邮箱查询，批量创建乘客，以及将乘客添加到旅行程序。
资源管理: 提供对旅行社、服务项目、酒店、导游、车辆、附加项目和语言等资源的列表查询和管理功能。
数据分析: 提供季度旅客统计摘要，帮助用户分析旅行社的业务数据。
灵活的日期处理: 支持多种日期格式输入，并统一转换为 LumbreTravel API 所需的 DD-MM-YYYY 格式。

安装步骤

前提条件

拥有 LumbreTravel API 的 Client ID 和 Client Secret。您可以在 LumbreTravel 开发者平台免费获取。
安装 Node.js 和 npm (或 npx)。

安装方式

可以通过 Smithery 自动安装或手动本地安装两种方式。推荐使用 NPX 方式，无需本地安装，更加便捷。

1. 通过 Smithery 安装 (推荐 Claude Desktop 用户)

如果您使用 Claude Desktop 等 MCP 客户端，可以使用 Smithery 简化安装过程：

npx -y @smithery/cli install @lumile/lumbretravel-mcp --client claude

2. NPX 方式 (推荐)

无需克隆仓库和本地安装，直接使用 'npx' 运行。

服务器配置

将以下 JSON 配置添加到您的 MCP 客户端配置文件中（例如 Claude Desktop 的配置文件）：

{
  "mcpServers": {
    "lumbretravel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lumbretravel-mcp"
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>",  // 替换为您的 LumbreTravel Client ID
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>", // 替换为您的 LumbreTravel Client Secret
        "EMAIL": "<YOUR_EMAIL>",        // 替换为您的 LumbreTravel 平台邮箱账号
        "PASSWORD": "<YOUR_PASSWORD>"     // 替换为您的 LumbreTravel 平台密码
      }
    }
  }
}

3. 本地安装方式

如果您希望本地安装和运行服务器，请按照以下步骤操作：

克隆仓库到本地：

git clone https://github.com/lumile/lumbretravel-mcp.git
cd lumbretravel-mcp

安装依赖：
```
npm install
```
构建项目：
```
npm run build
```

服务器配置

将以下 JSON 配置添加到您的 MCP 客户端配置文件中：

{
  "mcpServers": {
    "lumbretravel-mcp": {
      "command": "node",
      "args": [
        "/path/to/lumbretravel-mcp/dist/index.js" // 替换为您的本地仓库 dist/index.js 路径
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>",  // 替换为您的 LumbreTravel Client ID
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>", // 替换为您的 LumbreTravel Client Secret
        "EMAIL": "<YOUR_EMAIL>",        // 替换为您的 LumbreTravel 平台邮箱账号
        "PASSWORD": "<YOUR_PASSWORD>"     // 替换为您的 LumbreTravel 平台密码
      }
    }
  }
}

环境变量配置

无论使用 NPX 还是本地安装，都需要配置以下环境变量：

'CLIENT_ID': LumbreTravel API Client ID
'CLIENT_SECRET': LumbreTravel API Client Secret
'EMAIL': LumbreTravel 平台邮箱账号
'PASSWORD': LumbreTravel 平台密码

您可以在 MCP 客户端配置文件的 'env' 字段中直接配置，或者在您的运行环境中设置全局环境变量。

基本使用方法

启动 MCP 客户端 (如 Claude Desktop)。
客户端将自动连接到 LumbreTravel MCP Server。
在客户端中使用自然语言指令，例如：
- "查询今天的所有活动"
- "创建一个新的旅行程序，名称为'欧洲经典游'，开始日期为2024-12-25，结束日期为2025-01-05，旅行社ID为'agency-123'"
- "添加乘客'张三'到程序'欧洲经典游'"
- "获取所有酒店列表"

您可以使用自然语言指示 LLM 客户端调用 LumbreTravel MCP Server 提供的各种工具，管理您的 LumbreTravel 旅行平台数据。工具的具体名称和参数可以参考 'ToolsHandler.ts' 文件中的 'listTools' 方法的返回结果，或者在与 LLM 客户端的对话中，通过提问来探索可用的工具。

调试

可以使用仓库提供的 MCP Inspector 工具进行调试：

npm run inspector

该命令会启动 Inspector，并在浏览器中打开调试页面。

贡献

欢迎贡献新的 MCP 服务器或改进现有代码，请提交 Pull Request。

免责声明

本项目仅用于 LumbreTravel API。

关键词

LumbreTravel MCP Server 使用说明

项目简介

主要功能点

安装步骤

基本使用方法

信息