Doc MCP

🚀 🏥 MCP醫院助手

MCP醫院助手是一個全棧智能醫院預約管理系統，由React、Node.js、PostgreSQL和Mistral大語言模型（通過Ollama）提供支持。它旨在簡化醫院預約流程，提高管理效率，為醫院和患者提供便捷的服務體驗。

🚀 快速開始

項目環境準備

在開始使用本系統之前，你需要安裝以下依賴：

• PostgreSQL：用於存儲系統數據。
• Ollama：用於運行Mistral大語言模型。
• Node.js：用於運行後端服務器。
• npm：用於安裝項目依賴。

項目啟動步驟

1. 安裝PostgreSQL並創建數據庫

sudo apt install postgresql postgresql-contrib
sudo -u postgres psql

在psql中運行以下命令：

CREATE DATABASE mcp;
CREATE USER mcpuser WITH PASSWORD 'mcppass';
GRANT ALL PRIVILEGES ON DATABASE mcp TO mcpuser;

2. 創建數據庫表結構

連接到數據庫：

psql -U mcpuser -d mcp -h localhost

創建表結構：

CREATE TABLE doctors (
  doctor_id SERIAL PRIMARY KEY,
  name TEXT,
  department TEXT,
  available_slots JSONB
);

CREATE TABLE patients (
  patient_id SERIAL PRIMARY KEY,
  name TEXT,
  age INTEGER,
  contact TEXT
);

CREATE TABLE appointments (
  appointment_id SERIAL PRIMARY KEY,
  doctor_id INTEGER REFERENCES doctors(doctor_id),
  patient_id INTEGER REFERENCES patients(patient_id),
  appointment_time TEXT
);

CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  username TEXT UNIQUE,
  password TEXT
);

GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO mcpuser;
GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO mcpuser;

3. 安裝Ollama並運行Mistral模型

curl -fsSL https://ollama.com/install.sh | sh
ollama run mistral

確保本地Ollama服務器正在運行，並且監聽默認端口11434。

4. 後端項目啟動（Node.js）

cd backend/
npm install
node server.js

後端服務器將在http://localhost:3007啟動。

5. 前端項目啟動（React）

cd frontend/mcp-ui
npm install
npm start

前端項目將在http://localhost:3000啟動。

✨ 主要特性

可視化界面展示

🎥 演示視頻

▶️ 點擊此處觀看演示視頻

🏠 儀表盤

💬 大語言模型聊天助手

💬 手動預約

技術棧亮點

• 🔁 Node.js + Express：構建高效的後端服務器。
• 🎨 React.js（前端）：提供流暢的用戶界面。
• 🧠 大語言模型（Ollama - Mistral）：實現智能交互和自動化操作。
• 💾 PostgreSQL：穩定可靠的數據存儲。
• 🛡️ 基於會話的登錄：保障系統安全。

功能模式

✨ 模式1：通過用戶界面手動操作

你可以在主頁點擊圖標進行以下操作：

• ➕ 添加醫生
• ➕ 添加患者
• 📅 預約掛號
• 📋 查看醫生信息
• 📋 查看預約信息

這些用戶界面功能直接調用API端點（如/api/execute、/api/book等）。

🔍 模式2：智能助手（支持大語言模型）

在“詢問助手”聊天界面中，你可以輸入以下命令：

• 示例：顯示所有預約信息
• 示例：為患者John在10:00預約2號醫生

✅ 如果啟用了MCP工具（頂部複選框），大語言模型將：

• 🔎 理解用戶命令
• 🔧 從tools.json中選擇正確的工具
• 🧠 生成SQL語句
• 🔁 自動在後臺執行API調用

❌ 如果禁用，大語言模型僅提供普通回答（不改變系統狀態）。

安全認證

• 只有經過身份驗證的用戶才能訪問核心頁面。
• 註冊頁面將哈希後的憑證安全存儲在PostgreSQL中。
• 使用express-session存儲會話信息。

📦 項目結構

├── backend/
│   ├── server.js              # Node.js + Express後端
│   ├── config/config.js       # PostgreSQL配置文件
│   ├── mcp/                   # 所有業務邏輯處理程序
│   ├── auth/                  # 登錄、註冊、會話路由
├── frontend/
│   └── mcp-ui/                # React前端
│       ├── components/        # AddDoctor、Chat、Login、Home等組件
│       └── App.js             # 主路由控制器

💻 使用示例

基礎用法

以下是一些可以在大語言模型聊天界面輸入的示例命令：

顯示醫生表中的所有醫生信息
顯示11:00之後的預約信息
為30歲的John在09:00預約Renu醫生

功能特性對比