Doc MCP

🚀 🏥 MCP病院アシスタント

React、Node.js、PostgreSQL、そしてMistral LLM（Ollama経由）を活用したフルスタックのインテリジェント病院予約管理システムです。このシステムは、病院の予約管理を効率化し、ユーザーに便利な操作体験を提供します。

🔥 プレビュー

🎥 デモビデオ

▶️ ここをクリックしてデモを見る

🏠 ダッシュボード

💬 LLMチャットアシスタント

💬 手動予約

🔧 技術スタック

• 🔁 Node.js + Express
• 🎨 React.js（フロントエンド）
• 🧠 LLM（Ollama - Mistral）
• 💾 PostgreSQL
• 🛡️ セッションベースのログイン

📷 UIプレビュー

• ログイン / 登録ページ
• システムを手動で管理するボタンがあるダッシュボード
• 予約（手動）
• LLMを搭載した自動アシスタントインターフェース

📁 プロジェクト構造

├── backend/
│   ├── server.js              # Node.js + Expressのバックエンド
│   ├── config/config.js       # PostgreSQLの設定
│   ├── mcp/                   # すべてのビジネスロジックハンドラー
│   ├── auth/                  # ログイン、登録、セッションルート
├── frontend/
│   └── mcp-ui/                # Reactのフロントエンド
│       ├── components/        # AddDoctor、Chat、Login、Homeなど
│       └── App.js             # メインルートコントローラー

📦 インストール

1. ✅ PostgreSQLのインストールとデータベースの作成

sudo apt install postgresql postgresql-contrib
sudo -u postgres 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

以下のSQLを実行してテーブルを作成します。

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 で起動します。

🧠 主要機能

✨ モード1：手動UIを使用する

ホームページのアイコンをクリックすることで以下の操作ができます。

• ➕ 医師の追加
• ➕ 患者の追加
• 📅 予約の予約
• 📋 医師の表示
• 📋 予約の表示

これらのUI機能は、APIエンドポイント（/api/execute、/api/book など）を直接使用しています。

🔍 モード2：スマートアシスタント（LLM対応）

「Ask Assistant」チャットインターフェースから以下のようなコマンドを入力できます。

• 例：Show all appointments
• または：Book appointment for patient John with doctor 2 at 10:00

✅ MCP Toolsが有効になっている場合（上部のチェックボックス）、LLMは以下のことを行います。

• 🔎 ユーザーのコマンドを理解する
• 🔧 tools.json から正しいツールを選択する
• 🧠 SQLを生成する
• 🔁 自動的にAPI呼び出しを実行する

❌ 無効になっている場合、LLMは単に平文の回答を返します（システムに変更はありません）。

🔐 認証

• 認証されたユーザーのみがコアページにアクセスできます。
• 登録ページでは、ハッシュ化された資格情報がPostgreSQLに安全に保存されます。
• セッションは express-session を使用して保存されます。

📝 LLMの例題プロンプト

• Show all the doctors in doctor table
• Show appointments after 11:00
• Book an appointment with Dr. Renu at 09:00 for John (age 30)

✅ まとめ