MCP 服务器

LumbreTravel MCP Server

通过 MCP 客户端，方便访问 LumbreTravel API，以管理旅行计划、活动和相关实体。

旅行与交通

访问服务器

Tools

delete_hotel

Eliminar un hotel en LumbreTravel.

reactivate_hotel

Reactivar un hotel en LumbreTravel

get_hotel_by_name

Buscar hoteles por su nombre, retorna la lista de hoteles encontrados.

get_program

Obtiene un programa de viajes de LumbreTravel por ID

get_programs_by_name

Busca programas de viajes de LumbreTravel por nombre

get_programs_by_date_range

Obtiene programas de viajes de LumbreTravel por rango de fechas

daily_activities

Obtiene las actividades diarias en LumbreTravel. Retorna un objeto JSON con un array de actividaes en la propiedad 'activities' con las actividades del día buscado. En la propiedad 'monthlyTotals' se encuentra el total de actividades de cada día del mes

season_summary

Obtiene un resumen de pasajeros a lo largo de una temporada. Retorna un objeto JSON que contiene un array por cada año de la temporada. En cada item del array la propiedad 'yearTotal' contiene el total de pasajeros del año. En la propiedad 'agencies' se encuentra un resumen por mes de los pasajeros del año asociados a cada agencia. Y en el array 'monthlyTotals' se encuentra el total de pasajeros de cada mes. Esta tool es muy útil para obtener el total de pasajeros de una temporada y ver como se distribuye por agencias. Siempre que se quiera obtener información estadistica de pasajeros se debe usar esta tool. Al ser una solucion para agencias de viaje los analisis estadísticos pueden ser muy útiles para tomar decisiones de negocio. Se pueden usar estos datos para armar graficos e indicadores. Ademas es normal que las fechas de analisis sean en el futuro.

create_program

Crea un nuevo programa de viajes en LumbreTravel. Antes de crear un nuevo programa se debe preguntar al si quiere que primero se busque el programa a ver si existe. Si no se especifica la fecha de inicio o fin del programa, no la asumas, pide al usuario que la especifique. Si no se especifica el ID de la agencia, pide al usuario que la especifique.

update_program

Actualiza un programa de viajes en LumbreTravel

delete_program

Elimina un programa de viajes en LumbreTravel

reactivate_program

Reactiva un programa de viajes en LumbreTravel

list_agencies

Obtiene todas las agencias disponibles para asociar a un programa de viajes en LumbreTravel

list_services

Obtiene todos los servicios disponibles para asociar a una actividad en un programa de viajes en LumbreTravel

list_hotels

Obtiene todos los hoteles disponibles para asociar a una actividad en un programa de viajes en LumbreTravel

list_leaders

Obtiene todos los guías disponibles para asociar a una actividad en un programa de viajes en LumbreTravel

list_vehicles

Obtiene todos los vehículos disponibles para asociar a una actividad en un programa de viajes en LumbreTravel

list_includes

Obtiene todos los incluye o extras disponibles para asociar a una actividad en un programa de viajes en LumbreTravel

list_service_languages

Obtiene todos los idiomas en los que se pueden prestar los servicios para asociar a una actividad en un programa de viajes en LumbreTravel. Estos idiomas solo se pueden usar para asociar a un servicio. Estos idiomas solo pueden ser asociados a un servicio

list_providers

Obtiene todos los proveedores disponibles en LumbreTravel

get_passengers_by_fullname

Obtiene pasajeros por nombre completo en LumbreTravel

get_passengers_by_email

Obtiene pasajeros por email en LumbreTravel

reactivate_agency

Reactivar una agencia en LumbreTravel

create_passengers

Crea pasajeros en LumbreTravel, usa esta tool cuando el asistente recibe los datos de los pasajeros como parte del pedido del usuario

update_passengers

Edita pasajeros en LumbreTravel teniendo en cuenta que se conoce el ID del pasajero. Si el id no se conoce entonces se puede usar la tool get_passengers_by_fullname o get_passengers_by_email para obtener el id del pasajero. Retorna el pasajero editado.

delete_passengers

Elimina pasajeros en LumbreTravel teniendo en cuenta que se conoce el ID del pasajero. Si el id no se conoce entonces se puede usar la tool get_passengers_by_fullname o get_passengers_by_email para obtener el id del pasajero. Retorna el pasajero eliminado.

delete_passenger

Elimina un pasajero en LumbreTravel teniendo en cuenta que se conoce el ID del pasajero. Si el id no se conoce entonces se puede usar la tool get_passengers_by_fullname o get_passengers_by_email para obtener el id del pasajero. Retorna el pasajero eliminado.

reactivate_passenger

Reactiva un pasajero en LumbreTravel teniendo en cuenta que se conoce el ID del pasajero. Si el id no se conoce entonces se puede usar la tool get_passengers_by_fullname o get_passengers_by_email para obtener el id del pasajero. Retorna el pasajero reactivado.

add_passengers_to_program

Agrega pasajeros a un programa en LumbreTravel. Es importante que los pasajeros ya existan en LumbreTravel, si no existen se puede usar la tool create_passengers para crearlos. O si existen se puede usar la tool get_passengers_by_fullname o get_passengers_by_email para obtener el id de cada pasajero.

get_agency_by_name

Obtener una agencia por nombre, retorna la agencia encontrada.

create_hotel

Crear un hotel en LumbreTravel, retorna el hotel creado. Antes de crear un nuevo hotel se debe preguntar al si quiere que primero se busque el hotel a ver si existe.

update_hotel

Actualizar un hotel en LumbreTravel, retorna el hotel actualizado.

add_activities

Crea actividades asociadas a un programa en LumbreTravel. Es importante que los servicios, hoteles, guías, vehículos y extras ya existan en LumbreTravel, si no existen se puede usar las tools create_service, create_hotel, create_leader, create_vehicle y create_include para crearlos. O si existen se puede usar las tools get_services_by_name, get_hotel_by_name, get_leader_by_name, get_vehicle_by_name y get_include_by_name para obtener el id de cada servicio, hotel, guía, vehículo y extra.

update_activities

Actualizar múltiples actividades asociadas a un programa

delete_activities

Eliminar múltiples actividades asociadas a un programa

create_agency

Crear una agencia en LumbreTravel, retorna la agencia creada. Antes de crear una nueva agencia se debe preguntar al si quiere que primero se busque la agencia a ver si existe. La agencia creada se puede usar para asociarle programas en LumbreTravel. Es importante que el proveedor de la agencia tenga un ID de proveedor en LumbreTravel. Si el proveedor no tiene un ID de proveedor en LumbreTravel, se puede usar la tool create_provider para crear un proveedor y luego usar el ID de proveedor creado para crear la agencia. Si el proveedor ya tiene un ID de proveedor en LumbreTravel, se puede usar el ID de proveedor para crear la agencia. Para buscar un proveedor por nombre se puede usar la tool get_provider_by_name.

update_agency

Actualizar una agencia en LumbreTravel, retorna la agencia actualizada. La agencia actualizada se puede usar para asociarle programas en LumbreTravel. Es importante que el proveedor de la agencia tenga un ID de proveedor en LumbreTravel. Si el proveedor no tiene un ID de proveedor en LumbreTravel, se puede usar la tool create_provider para crear un proveedor y luego usar el ID de proveedor creado para crear la agencia. Si el proveedor ya tiene un ID de proveedor en LumbreTravel, se puede usar el ID de proveedor para crear la agencia. Para buscar un proveedor por nombre se puede usar la tool get_provider_by_name.

delete_agency

Eliminar una agencia en LumbreTravel. La agencia eliminada no se puede usar para asociarle programas en LumbreTravel.

create_leader

Crear un guía en LumbreTravel. Antes de crear un nuevo guía se debe preguntar al si quiere que primero se busque el guía a ver si existe.

update_leader

Actualizar un guía en LumbreTravel, retorna el guía actualizado. Es importante que el guía ya exista en LumbreTravel, si no existe se puede usar la tool create_leader para crearlo. O si existe se puede usar la tool get_leader_by_name para obtener el id del guía.

delete_leader

Eliminar un guía en LumbreTravel

reactivate_leader

Reactivar un guía en LumbreTravel

get_leader_by_name

Buscar guías por su nombre, retorna la lista de guías encontrados.

create_vehicle

Crear un vehículo en LumbreTravel. Antes de crear un nuevo vehículo se debe preguntar al si quiere que primero se busque el vehículo a ver si existe.

update_vehicle

Actualizar un vehículo en LumbreTravel, retorna el vehículo actualizado. Es importante que el vehículo ya exista en LumbreTravel, si no existe se puede usar la tool create_vehicle para crearlo. O si existe se puede usar la tool get_vehicle_by_name para obtener el id del vehículo.

delete_vehicle

Eliminar un vehículo en LumbreTravel

reactivate_vehicle

Reactivar un vehículo en LumbreTravel

get_vehicle_by_name

Buscar vehículos por su nombre, retorna la lista de vehículos encontrados.

create_include

Crear un extra o incluído en LumbreTravel. Antes de crear un nuevo extra o incluído se debe preguntar al si quiere que primero se busque el extra o incluído a ver si existe.

update_include

Actualizar un extra o incluído en LumbreTravel, retorna el extra o incluído actualizado. Es importante que el extra o incluído ya exista en LumbreTravel, si no existe se puede usar la tool create_include para crearlo. O si existe se puede usar la tool get_include_by_name para obtener el id del extra o incluído.

delete_include

Eliminar un extra o incluído en LumbreTravel

reactivate_include

Reactivar un extra o incluído en LumbreTravel

get_includes_by_name

Buscar extras o incluídos por su nombre, retorna la lista de extras o incluídos encontrados.

create_service_language

Crear un idioma de servicio en LumbreTravel. Antes de crear un nuevo idioma de servicio se debe preguntar al si quiere que primero se busque el idioma de servicio a ver si existe. Este idioma solo se puede usar para asociar a un servicio.

update_service_language

Actualizar un idioma de servicio en LumbreTravel, retorna el idioma de servicio actualizado. Es importante que el idioma de servicio ya exista en LumbreTravel, si no existe se puede usar la tool create_service_language para crearlo. O si existe se puede usar la tool get_service_language_by_name para obtener el id del idioma de servicio. Este idioma solo se puede usar para asociar a un servicio.

delete_service_language

Eliminar un idioma de servicio en LumbreTravel

reactivate_service_language

Reactivar un idioma de servicio en LumbreTravel

get_service_language_by_name

Buscar idiomas de servicio por su nombre, retorna la lista de idiomas de servicio encontrados.

create_provider

Crear un proveedor en LumbreTravel. Antes de crear un nuevo proveedor se debe preguntar al si quiere que primero se busque el proveedor a ver si existe.

update_provider

Actualizar un proveedor en LumbreTravel, retorna el proveedor actualizado. Es importante que el proveedor ya exista en LumbreTravel, si no existe se puede usar la tool create_provider para crearlo. O si existe se puede usar la tool get_provider_by_name para obtener el id del proveedor.

delete_provider

Eliminar un proveedor en LumbreTravel

reactivate_provider

Reactivar un proveedor en LumbreTravel

get_provider_by_name

Buscar proveedores por su nombre, retorna la lista de proveedores encontrados.

create_service

Crear un servicio en LumbreTravel. Antes de crear un nuevo servicio se debe preguntar al si quiere que primero se busque el servicio a ver si existe.

update_service

Actualizar un servicio en LumbreTravel, retorna el servicio actualizado. Es importante que el servicio ya exista en LumbreTravel, si no existe se puede usar la tool create_service para crearlo. O si existe se puede usar la tool get_services_by_name para obtener el id del servicio.

delete_service

Eliminar un servicio en LumbreTravel

reactivate_service

Reactivar un servicio en LumbreTravel

get_services_by_name

Buscar servicios por su nombre, retorna la lista de servicios encontrados.

README

LumbreTravel MCP 服务器

一个提供对 LumbreTravel API 访问的 MCP 服务器。

LumbreTravel 是一个用于管理旅行项目和活动的平台，这是它的 MCP 服务器。它允许你在 Claude Desktop 或其他 MCP 客户端上使用它。

功能

此 MCP 服务器允许访问 LumbreTravel API 提供的所有工具。

工具

项目

create_program - 创建一个新项目
update_program - 更新一个现有项目
delete_program - 删除一个项目
reactivate_program - 重新激活一个项目

活动

add_activities - 向项目添加活动
update_activities - 更新项目的活动
delete_activities - 删除项目的活动

乘客

get_passengers_by_fullname - 按全名获取乘客
get_passengers_by_email - 按电子邮件获取乘客
create_bulk_passengers - 批量创建乘客
create_passengers - 创建乘客
update_passengers - 更新乘客
delete_passengers - 删除乘客
reactivate_passenger - 重新激活乘客
add_passengers_to_program - 将乘客添加到项目

代理商

get_agencies - 获取代理商
get_agency_by_name - 按名称获取代理商
create_agency - 创建代理商
update_agency - 更新代理商
delete_agency - 删除代理商
reactivate_agency - 重新激活代理商

酒店

create_hotel - 创建酒店
update_hotel - 更新酒店
delete_hotel - 删除酒店
reactivate_hotel - 重新激活酒店
get_hotel_by_name - 按名称获取酒店
get_hotels - 获取酒店

服务

create_service - 创建服务
update_service - 更新服务
delete_service - 删除服务
reactivate_service - 重新激活服务
get_services_by_name - 按名称获取服务

服务语言

create_service_language - 创建服务语言
update_service_language - 更新服务语言
delete_service_language - 删除服务语言
reactivate_service_language - 重新激活服务语言
get_service_language_by_name - 按名称获取服务语言
get_service_languages - 获取服务语言

供应商

create_provider - 创建供应商
update_provider - 更新供应商
delete_provider - 删除供应商
reactivate_provider - 重新激活供应商
get_provider_by_name - 按名称获取供应商
get_providers - 获取供应商

领队

create_leader - 创建领队
update_leader - 更新领队
delete_leader - 删除领队
reactivate_leader - 重新激活领队
get_leaders - 获取领队

车辆

create_vehicle - 创建车辆
update_vehicle - 更新车辆
delete_vehicle - 删除车辆
reactivate_vehicle - 重新激活车辆
get_vehicles - 获取车辆

包含项

create_include - 创建包含项
update_include - 更新包含项
delete_include - 删除包含项
reactivate_include - 重新激活包含项
get_includes - 获取包含项

季节

get_season_summary - 获取季节总结

设置

前提条件

你需要一个 LumbreTravel 客户端 ID 和客户端密钥才能使用此服务器。你可以在 https://developers.mercadolibre.com/ 免费获取一个，创建一个应用程序并获取凭据。

获得凭据后，你可以设置 CLIENT_ID 和 CLIENT_SECRET 环境变量。

安装

有两种方法可以使用此服务器：

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 LumbreTravel MCP 服务器：

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

选项 1：NPX (推荐)

将此配置添加到你的 Claude Desktop 配置文件：

{
  "mcpServers": {
    "lumbretravel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lumbretravel-mcp"
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>",
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "EMAIL": "<YOUR_EMAIL>",
        "PASSWORD": "<YOUR_PASSWORD>"
      }
    }
  }
}

选项 2：本地安装

克隆存储库
安装依赖项：

npm install

构建服务器：

npm run build

将此配置添加到你的 Claude Desktop 配置：

{
  "mcpServers": {
    "lumbretravel-mcp": {
      "command": "node",
      "args": [
        "/path/to/lumbretravel-mcp/dist/index.js"
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>",
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "EMAIL": "<YOUR_EMAIL>",
        "PASSWORD": "<YOUR_PASSWORD>"
      }
    }
  }
}

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。我们建议使用 MCP Inspector，它作为一个包脚本提供：

npm run inspector

Inspector 将提供一个 URL 以在你的浏览器中访问调试工具。

贡献

非常欢迎贡献！请打开一个 PR，其中包含新的 MCP 服务器或对代码库的任何其他改进。

免责声明

此项目仅与 LumbreTravel API 一起使用。

许可证

有关详细信息，请参见 LICENSE.md 文件。

<p align="center"> 用 ❤️ 由 Lumile 制作 </p>

<p align="center"> <a href="https://www.lumile.com.ar">联系我们</a> 以获取定制的 AI 开发和自动化解决方案。 </p>