Neo4j预约系统 MCP 服务器

> 注意: 这是纯 MCP 服务器分支，已移除所有 API 相关代码。

项目介绍

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

功能模块

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

1. 预约管理：创建、查询、更新和取消预约
2. 顾客管理：顾客资料的管理和查询
3. 员工管理：员工资料的管理和查询
4. 服务管理：可预约服务或项目的管理
5. 类别管理：服务类别的管理
6. 会员等级管理：会员等级和权益管理
7. 员工可用性管理：管理员工的工作时间和可用性
8. 员工服务能力管理：管理员工可提供的服务
9. 通知系统：向客户发送预约通知
10. 商业统计：业务数据统计和分析
11. 广告管理：广告创建和审核
12. 用户关系管理：用户之间的关系维护

技术栈

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

安装与运行

1. 确保已安装Node.js和Neo4j数据库
2. 克隆项目到本地
3. 安装依赖：npm install
4. 复制.env.example文件为.env，并配置相关环境变量
5. 执行初始化：npm run initialize
6. 启动服务：npm start

开发工作流程

本项目已简化开发流程，提供以下命令：

| 命令 | 描述 |
|------|------|
| npm run initialize | 执行一次性初始化任务，包括数据库索引创建、工具定义生成和文档生成 |
| npm run build | 编译TypeScript代码 |
| npm start | 以生产模式启动服务器 |
| npm run dev | 以开发模式启动服务器（自动编译TypeScript） |
| npm test | 运行测试用例 |

重要说明

- initialize 命令仅需在首次设置或需要重新生成资源时执行
- 日常开发使用 npm run dev
- 部署前构建使用 npm run build
- 生产环境启动使用 npm start

环境变量配置

创建.env文件，包含以下配置：

```
NEO4J_URI=neo4j://localhost:7687
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=your_password
PORT=3003