IAMZOE MCP SERVER

The Neo4j Appointment System MCP Server based on the Neo4j graph database provides complete functions such as appointment management, customer management, and employee management, and supports MCP tools for large - language models.

Database Schedule management #Appointment System #Graph Database #MCP Tool #Business Management .JavaScript

rating : 2 points

downloads : 12

update time : 2025-04-29

What is the Neo4j Appointment System MCP Server?

This is a backend system designed specifically for appointment management, using graph database technology to store and query complex business relationship data. The system can help merchants efficiently manage appointment services, including core functions such as customer appointments, employee scheduling, and service items.

How to use the appointment system?

The system provides complete management functions. Merchants can perform operations such as appointment management, employee scheduling, and customer management through the interface or API. The system will automatically handle business processes such as appointment conflicts and send notifications.

Applicable scenarios

It is particularly suitable for service industries that need to manage complex appointment relationships, such as beauty salons, medical institutions, and educational institutions that need to manage the many - to - many relationships between customers, employees, and services.

Main Features

Appointment ManagementCreate, query, update, and cancel appointments, and automatically handle time conflicts

Customer ManagementMaintain customer information, record consumption history and preferences

Employee ManagementManage employee information, skills, and working hours

Service ManagementMaintain bookable service items and their classifications

Notification SystemAutomatically send appointment confirmations and reminders to customers

Business StatisticsProvide business data analysis reports to assist decision - making

Advantages and Limitations

Advantages

Graph database efficiently processes complex relationship data

Flexible business model adapts to various appointment scenarios

Real - time data update and query

Highly scalable, easy to add new functions

Limitations

Requires Neo4j database support

The learning curve is slightly steeper than traditional relational database systems

Initial configuration is relatively complex

How to Use

Environment Preparation

Install Node.js and Neo4j database

Install the Project

Clone the project and install dependencies

Configure the Environment

Set database connection information

Initialize the System

Create database indexes and constraints

Start the Service

Run the system

Usage Examples

Beauty Salon Appointment ManagementA beauty salon uses the system to manage beautician schedules, customer appointments, and service items

Clinic Patient ManagementA clinic manages doctor schedules and patient appointments

Frequently Asked Questions

What kind of hardware configuration does the system require?

Can it be integrated into an existing system?

How to back up the data?

Related Resources

Neo4j Official Documentation

Documentation for using the Neo4j database

Node.js Official Website

Node.js runtime environment

Project GitHub Repository

System source code

🚀 Appointment System MCP Server Based on Neo4j

This project is an Appointment System MCP Server built on the Neo4j graph database, supporting functions such as appointment management, customer management, employee management, service management, and report analysis. It provides a complete MCP toolset for large language models like Claude.

⚠️ Important Note

This repository is a pure MCP server branch, and all API-related code has been removed.

🚀 Quick Start

✨ Features

The project mainly includes the following functional modules:

Appointment Management: Create, query, update, and cancel appointments.
Customer Management: Manage and query customer profiles.
Employee Management: Manage and query employee information.
Service Management: Manage bookable services or projects.
Category Management: Maintain and manage service categories.
Membership Level Management: Manage membership levels and related benefits.
Employee Availability Management: Set and manage employees' working hours and availability status.
Employee Service Capability Management: Define the specific services employees can provide.
Notification System: Send appointment reminders and other notifications to customers.
Business Statistics: Provide statistical and analytical functions for business data.
Advertising Management: Create and review advertising content.
User Relationship Management: Maintain the relationship network between users.

🔧 Technical Details

Backend Framework: Node.js
Database: Neo4j Graph Database
MCP Integration: @modelcontextprotocol/sdk

📦 Installation

Ensure that Node.js and the Neo4j database are installed.
Clone the project to your local development environment.
Execute the command in the terminal to install dependencies: npm install.
Copy the .env.example file and rename it to .env, then configure the corresponding environment variables.
Run the initialization command: npm run initialize.
Start the server: npm start.

📚 Documentation

Development Process

The project provides a simplified development workflow:

Command	Description
`npm run initialize`	Perform one-time initialization tasks, including database index creation, tool definition generation, and document construction.
`npm run build`	Compile TypeScript code files.
`npm start`	Start the server in production mode.
`npm run dev`	Start the server in development mode (supports automatic TypeScript compilation).
`npm test`	Run unit test cases.

⚠️ Important Note

The initialize command should only be used during the initial deployment or when resources need to be regenerated.

It is recommended to use npm run dev for daily development.

It is recommended to use npm start in the production environment.

Environment Variable Configuration

The environment variables required for the project to run are as follows:

# Database connection information
NEO4J_URI=bolt://localhost:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=your_password

# Other configuration options (optional)
NODE_ENV=development
PORT=3000

Project Structure

src/
├── tools/           # MCP tool definition folder for interacting with LLM
├── utils/          # Utility functions and helper functions
├── models/         # Data models and business logic implementation
├── routes/         # API route definitions (for internal use only)
└── config/         # Project configuration files

Database Model

The system defines the following main node types:

Customer: User information node
Employee: Employee information node
Service: Bookable service node
Appointment: Appointment record node
Notification: Notification record node
Advertisement: Advertising content node

All nodes are connected through relationship attributes to ensure efficient and accurate data querying.

Database Optimization

When executing the npm run initialize command, the system will automatically create the necessary indexes and constraints to improve query performance and ensure data consistency. Specifically, it includes:

Adding indexes to frequently queried fields.
Setting uniqueness constraints to avoid duplicate data.
Creating association relationships to optimize complex queries.

MCP Tools

This project provides various MCP tools for LLMs such as Claude. The tool definition files are located in the src/tools/ directory. A complete tool documentation will be automatically generated after executing the initialization command.

For detailed usage instructions, please refer to: docs/Tools-Usage-Guide.md