mcp-server-booking

# CUHKSZ Booking MCP 服务器 一个基于模型上下文协议 (MCP) 的香港中文大学（深圳）场馆预订系统接口服务。 ## 📋 目录 - [项目描述](#项目描述) - [可用工具](#可用工具) - [安装与部署](#安装与部署) - [测试说明](#测试说明) - [项目架构](#项目架构) - [实现方式与核心逻辑](#实现方式与核心逻辑) - [故障排除](#故障排除) - [许可证与免责声明](#许可证与免z声明) ## ✨ 项目描述 一个基于模型上下文协议 (MCP) 的香港中文大学（深圳）场馆预订系统接口服务，该服务使语言模型能够查询场地信息、检查可用时段并执行在线预订。 ## 🛠️ 可用工具 本服务提供了一套结构化的工具，用于查询和预订场地。推荐的调用流程是： 1. 使用 `booking_get_field_info` 获取目标场地类型的总体信息，包括其下的具体场所列表及其 ID。 2. 使用 `booking_get_all_available_slots` 查看指定时间范围内所有场地的详细可用时间段。 3. 使用 `booking_get_available_places` 查询在特定时间段内，哪些具体场所是可用的。 4. 使用 `booking_book` 预订一个确切的可用场所。 --- ### 1. `booking_get_field_info` 查询指定场地类型在某一天内的基本信息，包括所有具体场所的列表和当天的预订情况。 - **参数说明**: - `field` (`Literal["badminton"]`): **必须**。要查询的场地类型。 - **约束**: 目前仅支持 `"badminton"`。必须使用英文名称。 - `start_time` (`string`): **必须**。查询范围的开始时间。 - **格式**: `YYYY-MM-DD HH:MM`。 - `end_time` (`string`): **必须**。查询范围的结束时间。 - **格式**: `YYYY-MM-DD HH:MM`。 - **返回示例**: ``` 场地信息: 场地名称: badminton 场地ID: 1097 可用场所: - 羽毛球场1 (ID: 1100) - 羽毛球场2 (ID: 1101) ... 当前预订 (3 个): - Booker: 张三, Start Time: ..., End Time: ..., Reason: ..., PlaceID: 1100 ... ``` --- ### 2. `booking_get_all_available_slots` 查询指定时间范围内，每个场地所有可用的具体时间段。这会返回一个详细的时间段列表，显示每个场地在指定日期范围内的所有可用时间段。 - **参数说明**: - `field` (`Literal["badminton"]`): **必须**。要查询的场地类型。 - **约束**: 目前仅支持 `"badminton"`。必须使用英文名称。 - `start_time` (`string`): **必须**。查询的开始时间。 - **格式**: `YYYY-MM-DD HH:MM`。 - `end_time` (`string`): **必须**。查询的结束时间。 - **格式**: `YYYY-MM-DD HH:MM`。 - **返回示例**: ``` 查询时间段 2025-01-01 08:00 到 2025-01-01 22:00 内的所有可用时间段: 场地: 羽毛球场1 (ID: 1100) - 2025-01-01 08:00 到 2025-01-01 09:00 - 2025-01-01 10:00 到 2025-01-01 12:00 - 2025-01-01 14:00 到 2025-01-01 16:00 场地: 羽毛球场2 (ID: 1101) - 2025-01-01 09:00 到 2025-01-01 11:00 - 2025-01-01 13:00 到 2025-01-01 15:00 ``` --- ### 3. `booking_get_available_places` 根据 `booking_get_field_info` 的结果，查询在您指定的时间段内，哪些具体的场所是空闲的。 - **参数说明**: - `…