健身约课助手 MCP 服务

📋 服务简介

这是一个专为健身教练设计的智能约课助手 MCP 服务，帮助教练与会员进行高效的课程预订和日程管理。

当用户提出以下需求时，大模型应使用此服务：

• 🏋️ 健身约课、预订私教课程
• 📅 查看教练或会员的时间安排
• 🏢 预订健身房场地（私教室、团课教室等）
• 👥 查找教练或学员信息
• 📝 管理健身房预订记录

🛠️ 提供的工具

1. get_user_profile - 【约课第一步】获取用户基本信息

当用户提出任何约课、查看日程、预订场地等健身相关请求时，必须首先调用此工具确认当前对话用户的身份和角色。

2. get_user_relationships - 【快速约课模式】获取用户关系网络

在确认用户身份后，获取用户现有的教学/学习关系网络。教练返回可约课的学员列表，学员返回可约课的教练列表。用于快速约课场景。

3. get_course_info - 【约课辅助工具】获取课程详细信息

根据课程ID获取课程的详细信息，包括时长、类型等预订所需的关键信息。

4. find_user - 【探索约课模式】查找用户

当用户需要寻找新教练或学员时使用。支持按姓名或专业领域模糊匹配，适用于"我想学游泳，有推荐的教练吗？"等探索性需求。

5. get_user_available_time - 【约课时间确认】获取用户可用时间

获取指定用户在指定日期的可用时间段。在确定约课对象后，用于查询双方的时间可用性。

6. get_venue_availability - 【约课场地确认】获取场地可用性

获取指定日期和课程类型的场地可用时间段。根据课程类型自动筛选合适的场地（私教室/团课教室）。

7. book_session - 【约课最终步骤】预订课程

执行课程预订，创建预订记录。必须在确认用户身份、时间可用性、场地可用性后调用。

🔄 约课模式

快速约课模式

适用于已有师生关系的约课场景：

1. get_user_profile → 确认用户身份
2. get_user_relationships → 获取可约课的教练/学员
3. get_user_available_time → 查询时间可用性
4. get_venue_availability → 查询场地可用性
5. book_session → 完成预订

探索约课模式

适用于寻找新教练或课程的场景：

1. get_user_profile → 确认用户身份
2. find_user → 搜索教练或学员
3. get_course_info → 了解课程详情
4. get_user_available_time → 查询时间可用性
5. get_venue_availability → 查询场地可用性
6. book_session → 完成预订

🔒 隐私保护

• 教练信息：学员可查看专业信息，不可查看私人联系方式
• 学员信息：教练可查看基本信息，不可查看敏感信息
• 课程信息：只能通过课程ID查询，保护私教课隐私

⏰ 时间段映射

• 上午：08:00-12:00
• 中午：12:00-14:00
• 下午：14:00-18:00
• 晚上：18:00-22:00

📦 安装使用

# 全局安装
npm install -g mcp-booking-service

# 在 Claude Desktop 配置文件中添加：
{
  "mcpServers": {
    "fitness-booking": {
      "command": "npx",
      "args": ["mcp-booking-service"]
    }
  }
}

🎯 使用场景

• 健身教练：管理与会员的约课安排
• 健身房前台：协助处理预订和时间查询
• 会员：通过智能助手预订课程
• 健身房管理：优化场地利用率和时间安排

🏗️ 数据结构

服务包含完整的健身房业务数据：

• 👨‍🏫 教练信息和日程（李教练-健身、王教练-网球、赵教练-游泳）
• 👥 会员信息和可用时间（张三、李四、王五）
• 🏢 场地信息和预订状态（私教室A、游泳池私教区、团课教室A）
• 📋 预订记录管理

📝 更新日志

v1.3.4 (2025-09-17)

• 🔄 优化工具描述，明确约课流程规范
• 🚨 强调 get_user_profile 为约课必备第一步
• 🎯 完善快速约课和探索约课两种模式说明
• 📅 更新用户日程数据，确保8:00-22:00完整时间覆盖

v1.3.3

• 🔧 优化时间交集计算算法，支持多人约课场景
• 📖 完善文档和测试用例

v1.3.0

• 初始版本发布
• 基础约课功能实现

让健身约课变得更智能、更高效！