Back to MCP directory
publicPublicdnsLocal runtime

booking-system-fixed

该项目是一个修复版的预约系统,基于Cloudflare Workers构建,集成了Google日历和MCP服务器,解决了原系统的关键问题,包括预约完成、确认邮件发送、日历集成等,并新增了实时可用性检查等功能。

article

README

🚀 预订系统(已修复)

本项目提供了Andriana Delcheva预订系统的修复版本,有效解决了原系统中的多个关键问题。该系统可在Cloudflare Workers上运行,并与谷歌日历和MCP服务器集成,为用户提供更稳定、高效的预订服务。

🚀 快速开始

此预订系统设计为在Cloudflare Workers上运行,以下是启动系统的步骤:

安装依赖

npm install

启动应用

npm start

✨ 主要特性

  • 多步骤预订流程:用户可分多个步骤逐步完成预订,每一步都有验证机制,确保信息准确无误。
  • 单次API请求:最终的预订请求通过一次API调用完成,简化流程,提升效率。
  • 全面错误处理:涵盖验证错误、网络错误和服务器错误的日志记录,并通过MCP集成处理,为用户提供友好的错误提示。

🛠️ 已解决问题

本实现解决了原始系统中存在的以下问题:

  1. 完成预订:用户能够成功选择日期并完成预订。
  2. 确认电子邮件:预订成功后,系统会发送确认邮件。
  3. 谷歌日历集成:预订信息会同步到谷歌日历,创建相应事件。
  4. 实现可用性检查:系统在确认预订前,会检查可用时间段。
  5. 实现MCP服务器集成:后台处理借助MCP服务器,增强系统功能。

📚 详细文档

📋 API端点

检查可用性

POST /api/available

请求体:

{
  "date": "2025-03-15",
  "duration": 60
}

响应:

{
  "success": true,
  "availableTimeslots": [
    { "startTime": "09:00", "endTime": "10:00" },
    { "startTime": "10:00", "endTime": "11:00" },
    /* ... */
  ]
}

创建预约

POST /api/book

请求体:

{
  "name": "John Doe",
  "email": "john@example.com",
  "phone": "+1234567890",
  "date": "2025-03-15",
  "time": "10:00",
  "services": [
    {
      "name": "按摩",
      "duration": 60,
      "price": 80
    }
  ],
  "notes": "备注信息",
  "同意条款": true
}

响应:

{
  "success": true,
  "message": "预约已成功创建",
  "bookingId": "BK-JOHNDO-123456",
  "eventId": "日历事件ID"
}

🔄 持续改进

未来可能的改进方向包括:

  • 添加预订管理仪表盘。
  • 实现预订取消和重新安排功能。
  • 集成支付系统。
  • 创建客户账户系统。
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client