🚀 基于Neo4j的预约系统 MCP 服务器
本项目是一个基于Neo4j图数据库构建的预约系统MCP服务器，具备预约管理、顾客管理、员工管理等丰富功能，能为Claude等大型语言模型提供完整的MCP工具集。
🚀 快速开始
本项目是一个基于Neo4j图数据库构建的预约系统MCP服务器，支持预约管理、顾客管理、员工管理、服务管理、报表分析等功能，专为Claude等大型语言模型提供完整的MCP工具集。
✨ 主要特性
项目主要包括以下功能模块：
- 预约管理：实现预约的创建、查询、更新和取消
- 顾客管理：对顾客资料进行管理和查询
- 员工管理：管理员工信息及查询
- 服务管理：管理可预约的服务或项目
- 类别管理：服务类别的维护与管理
- 会员等级管理：管理会员等级和相关权益
- 员工可用性管理：设置并管理员工的工作时间和可用状态
- 员工服务能力管理：定义员工能提供的具体服务
- 通知系统：向客户发送预约提醒和其他通知
- 商业统计：提供业务数据的统计与分析功能
- 广告管理：创建和审核广告内容
- 用户关系管理：维护用户之间的关系网络
🔧 技术细节
技术架构
- 后端框架：Node.js
- 数据库：Neo4j图数据库
- MCP集成：@modelcontextprotocol/sdk
数据库模型说明
本系统定义了以下主要节点类型：
- Customer：用户信息节点
- Employee：员工信息节点
- Service：可预约服务节点
- Appointment：预约记录节点
- Notification：通知记录节点
- Advertisement：广告内容节点
所有节点间通过关系属性进行连接，确保数据查询高效准确。
数据库优化说明
执行npm run initialize命令时，系统会自动创建必要的索引和约束，以提升查询性能并保证数据一致性。具体包括：
- 为频繁查询的字段添加索引
- 设置唯一性约束避免重复数据
- 创建关联关系以优化复杂查询
📦 安装指南
- 确保已安装Node.js和Neo4j数据库
- 克隆项目到本地开发环境
- 在终端中执行命令安装依赖：
npm install - 复制
.env.example文件并重命名为.env，然后配置相应的环境变量 - 运行初始化命令：
npm run initialize - 启动服务器：
npm start
📚 详细文档
开发流程说明
项目提供了简化的开发工作流：
| 命令 | 描述 |
|---|---|
npm run initialize |
执行一次性初始化任务，包括数据库索引创建、工具定义生成和文档构建 |
npm run build |
编译TypeScript代码文件 |
npm start |
以生产模式启动服务器 |
npm run dev |
以开发模式启动服务器（支持自动编译TypeScript） |
npm test |
运行单元测试用例 |
注意事项
initialize命令仅在首次部署或需要重新生成资源时使用- 日常开发建议使用
npm run dev - 生产环境推荐使用
npm start
环境变量配置
项目运行所需环境变量如下：
# 数据库连接信息
NEO4J_URI=bolt://localhost:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=your_password
# 其他配置选项（可选）
NODE_ENV=development
PORT=3000
项目结构说明
src/
├── tools/ # MCP工具定义文件夹，用于与LLM交互
├── utils/ # 工具函数和辅助函数
├── models/ # 数据模型和业务逻辑实现
├── routes/ # API路由定义（仅限内部使用）
└── config/ # 项目配置文件
MCP工具说明
本项目为Claude等LLM提供多种MCP工具，工具定义文件位于src/tools/目录下。执行初始化命令后会自动生成完整的工具文档。
详细使用指南请参考：docs/Tools-Usage-Guide.md
联系方式
如需反馈或技术支持，请联系项目负责人。
⚠️ 重要提示
该仓库是纯MCP服务器分支，所有API相关代码已移除。