Neo4j预约系统 MCP 服务器
golfamigo
README
Neo4j预约系统 MCP 服务器
注意: 这是纯 MCP 服务器分支，已移除所有 API 相关代码。
项目介绍
本项目是一个基于Neo4j图数据库的预约系统 MCP 服务器，支持预约管理、顾客管理、员工管理、服务管理、报表分析等功能，为 Claude 等大型语言模型提供了一套完整的 MCP 工具。
功能模块
项目主要包含以下功能模块：
- 预约管理：创建、查询、更新和取消预约
- 顾客管理：顾客资料的管理和查询
- 员工管理：员工资料的管理和查询
- 服务管理：可预约服务或项目的管理
- 类别管理：服务类别的管理
- 会员等级管理：会员等级和权益管理
- 员工可用性管理：管理员工的工作时间和可用性
- 员工服务能力管理：管理员工可提供的服务
- 通知系统：向客户发送预约通知
- 商业统计：业务数据统计和分析
- 广告管理：广告创建和审核
- 用户关系管理：用户之间的关系维护
技术栈
- 后端框架：Node.js
- 数据库：Neo4j图数据库
- MCP集成：@modelcontextprotocol/sdk
安装与运行
- 确保已安装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 run build - 生产环境启动使用
npm start
环境变量配置
创建.env文件，包含以下配置：
NEO4J_URI=neo4j://localhost:7687
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=your_password
PORT=3003
# 数据库初始化设置
# 设置为 true 表示跳过数据库索引和约束的初始化
# 首次部署时设置为 false，之后可改为 true 以提高启动速度
SKIP_DB_INIT=true
开发说明
项目结构
├── dist/ # 编译后的JavaScript文件
├── docs/ # 文档目录
├── src/
│ ├── scripts/ # 脚本文件
│ │ └── initialize/ # 初始化脚本
│ ├── tools/ # MCP工具实现
│ ├── types/ # TypeScript类型定义
│ ├── utils/ # 工具函数
│ ├── db.ts # 数据库连接模块
│ └── index.ts # 主入口文件
├── .env # 环境变量配置
├── package.json # 项目依赖和脚本
└── README.md # 项目说明文档
数据库模型
项目使用Neo4j图数据库，遵循"Gemini完善的资料模型.md"中定义的节点和关系模型。主要节点类型包括:
- :Business - 商家节点
- :User - 用户节点
- :Customer - 顾客节点
- :Staff - 员工节点
- :BookableItem - 可预约项目节点
- :Booking - 预约节点
- :Category - 类别节点
- :MembershipLevel - 会员等级节点
- :StaffAvailability - 员工可用性节点
- :Notification - 通知节点
- :Advertisement - 广告节点
详细的数据模型请参考"Gemini完善的资料模型.md"文档。
数据库索引和约束
数据库索引和约束已在初始化脚本中设置，确保数据完整性和查询性能。执行npm run initialize时会自动创建所需的索引和约束。
MCP工具说明
本项目为Claude等LLM提供MCP工具，工具定义存储在src/tools目录下。执行npm run initialize会自动生成工具定义和文档。
工具使用文档位于docs/Tools-Usage-Guide.md，详细说明了每个工具的功能、参数和示例。
联系方式
如有问题，请联系项目负责人。
Recommended Servers
Crypto Price & Market Analysis MCP Server
A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface.
MCP PubMed Search
Server to search PubMed (PubMed is a free, online database that allows users to search for biomedical and life sciences literature). I have created on a day MCP came out but was on vacation, I saw someone post similar server in your DB, but figured to post mine.
dbt Semantic Layer MCP Server
A server that enables querying the dbt Semantic Layer through natural language conversations with Claude Desktop and other AI assistants, allowing users to discover metrics, create queries, analyze data, and visualize results.
mixpanel
Connect to your Mixpanel data. Query events, retention, and funnel data from Mixpanel analytics.
Sequential Thinking MCP Server
This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.
Nefino MCP Server
Provides large language models with access to news and information about renewable energy projects in Germany, allowing filtering by location, topic (solar, wind, hydrogen), and date range.
Vectorize
Vectorize MCP server for advanced retrieval, Private Deep Research, Anything-to-Markdown file extraction and text chunking.
Mathematica Documentation MCP server
A server that provides access to Mathematica documentation through FastMCP, enabling users to retrieve function documentation and list package symbols from Wolfram Mathematica.
kb-mcp-server
An MCP server aimed to be portable, local, easy and convenient to support semantic/graph based retrieval of txtai "all in one" embeddings database. Any txtai embeddings db in tar.gz form can be loaded
Research MCP Server
The server functions as an MCP server to interact with Notion for retrieving and creating survey data, integrating with the Claude Desktop Client for conducting and reviewing surveys.