IAMZOE MCP SERVER

🚀 基於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相關代碼已移除。