🚀 基于Neo4j的预约系统 MCP 服务器

本项目是一个基于Neo4j图数据库构建的预约系统MCP服务器，具备预约管理、顾客管理、员工管理等丰富功能，能为Claude等大型语言模型提供完整的MCP工具集。

🚀 快速开始

本项目是一个基于Neo4j图数据库构建的预约系统MCP服务器，支持预约管理、顾客管理、员工管理、服务管理、报表分析等功能，专为Claude等大型语言模型提供完整的MCP工具集。

✨ 主要特性

项目主要包括以下功能模块：

1. 预约管理：实现预约的创建、查询、更新和取消
2. 顾客管理：对顾客资料进行管理和查询
3. 员工管理：管理员工信息及查询
4. 服务管理：管理可预约的服务或项目
5. 类别管理：服务类别的维护与管理
6. 会员等级管理：管理会员等级和相关权益
7. 员工可用性管理：设置并管理员工的工作时间和可用状态
8. 员工服务能力管理：定义员工能提供的具体服务
9. 通知系统：向客户发送预约提醒和其他通知
10. 商业统计：提供业务数据的统计与分析功能
11. 广告管理：创建和审核广告内容
12. 用户关系管理：维护用户之间的关系网络

🔧 技术细节

技术架构

• 后端框架：Node.js
• 数据库：Neo4j图数据库
• MCP集成：@modelcontextprotocol/sdk

数据库模型说明

本系统定义了以下主要节点类型：

• Customer：用户信息节点
• Employee：员工信息节点
• Service：可预约服务节点
• Appointment：预约记录节点
• Notification：通知记录节点
• Advertisement：广告内容节点

所有节点间通过关系属性进行连接，确保数据查询高效准确。

数据库优化说明

执行npm run initialize命令时，系统会自动创建必要的索引和约束，以提升查询性能并保证数据一致性。具体包括：

• 为频繁查询的字段添加索引
• 设置唯一性约束避免重复数据
• 创建关联关系以优化复杂查询

📦 安装指南

1. 确保已安装Node.js和Neo4j数据库
2. 克隆项目到本地开发环境
3. 在终端中执行命令安装依赖：npm install
4. 复制.env.example文件并重命名为.env，然后配置相应的环境变量
5. 运行初始化命令：npm run initialize
6. 启动服务器：npm start

📚 详细文档

开发流程说明

项目提供了简化的开发工作流：

注意事项

• 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相关代码已移除。