预约系统 MCP 服务器

这是一个基于 Model Context Protocol (MCP) 的微信云开发预约系统API服务器，允许AI模型安全地访问和管理预约数据。

功能特性

🔧 支持的工具

1. query_reservations - 查询预约记录

   • 支持按用户ID、状态、预约项目ID筛选

   • 可设置返回记录数限制

   • 返回格式化的预约信息

2. update_reservation_status - 更新预约状态

   • 取消预约（状态设为10）

   • 恢复预约（状态设为1）

   • 系统取消（状态设为99）

   • 可添加取消理由

3. delete_reservation - 删除预约记录

   • 永久删除指定预约记录

   • 不可撤销操作，需谨慎使用

📊 预约状态说明

• 1 - ✅ 预约成功

• 10 - ❌ 已取消

• 99 - ⚠️ 系统取消

安装和配置

1. 安装依赖

2. 配置环境变量

复制环境变量示例文件并配置：

编辑 .env 文件：

3. 构建项目

4. 启动服务器

或开发模式：

在AI客户端中使用

配置MCP客户端

在你的AI客户端配置文件中添加这个MCP服务器：

Claude Desktop 配置示例

使用示例

查询预约记录

取消预约

删除预约

API参考

微信云开发API端点

本MCP服务器使用以下微信云开发API：

• 获取Access Token: GET https://api.weixin.qq.com/cgi-bin/token

• 数据库查询: POST https://api.weixin.qq.com/tcb/databasequery

• 数据库更新: POST https://api.weixin.qq.com/tcb/databaseupdate

• 数据库删除: POST https://api.weixin.qq.com/tcb/databasedelete

数据库集合

• ax_join: 预约记录表

  • JOIN_ID: 预约记录ID

  • JOIN_USER_ID: 用户ID

  • JOIN_MEET_ID: 预约项目ID

  • JOIN_MEET_TITLE: 预约项目标题

  • JOIN_STATUS: 预约状态

  • JOIN_REASON: 取消理由

  • 其他字段...

安全注意事项

1. 环境变量保护: 确保微信AppSecret等敏感信息通过环境变量设置，不要硬编码在代码中

2. 访问权限: 确保只有受信任的AI客户端可以访问此MCP服务器

3. 操作日志: 服务器会记录所有API调用，便于审计

4. 数据备份: 删除操作不可撤销，建议定期备份重要数据

故障排除

常见错误

1. AccessToken不合法 (40014)

   • 检查AppID和AppSecret是否正确

   • 确认IP白名单设置

2. AccessToken过期 (42001)

   • 服务器会自动刷新token，如持续出现请检查系统时间

3. 数据库查询失败

   • 检查云环境ID是否正确

   • 确认数据库集合是否存在

调试模式

设置环境变量启用调试日志：

开发

项目结构

构建命令

• npm run build - 编译TypeScript

• npm run dev - 开发模式运行

• npm run clean - 清理构建文件

许可证

MIT License

贡献

欢迎提交Issue和Pull Request！