vghsdk_mcp

VGH 榮總內網爬蟲 MCP Server - 使用 FastMCP 框架。

⚠️ 注意: 僅能在 VGH 內網環境中使用。

功能

• 🔧 27 個 MCP Tools - 病人、手術、門診、住院、同意書、IVI 查詢
• 🔐 統一認證 - 每次呼叫提供 EIP 帳密
• ⚡ Session 共享 - 同一帳號重用 session
• 📅 統一日期格式 - 所有日期參數使用 ISO YYYY-MM-DD 格式

需求

• Python ≥ 3.10
• uv
• VGH 內網

安裝

git clone https://github.com/eyeduck-ai/vghsdk-mcp.git
cd vghsdk-mcp
uv sync

啟動

uv run python -m vghsdk_mcp

MCP Client 設定

支援 Claude Desktop、ChatGPT、Google CLI 等 MCP 客戶端，設定格式相同：

{
  "mcpServers": {
    "vghsdk": {
      "command": "uv",
      "args": ["--directory", "/path/to/vghsdk-mcp", "run", "python", "-m", "vghsdk_mcp"]
    }
  }
}

設定檔位置:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor: .cursor/mcp.json (專案根目錄)

認證

所有 Tools 需要:

參數	說明
eip_id	EIP 帳號
eip_password	EIP 密碼

日期格式

統一規則: 所有日期參數使用 YYYY-MM-DD 格式 (ISO 8601)。

# 所有函數都使用相同格式
await surgery_doc_schedule_list(..., date='2025-12-30')
await doc_opd_patient_list_previous(..., date='2025-12-19')
await patient_op_note(..., dt='2025-11-04')
await patient_ad_note(..., adidate='2025-09-30')

函數會自動轉換為內網 API 需要的格式 (民國/西元)。

可用 Tools (27 個)

Patient (15)

Tool	說明
patient_search	搜尋病人
patient_info	基本資料
patient_opd_list	門診清單
patient_opd_note	門診 SOAP
patient_opd_list_search	門診搜尋 (regex)
patient_op_list	已完成手術紀錄
patient_op_schedule	預定手術排程
patient_op_note	手術病歷
patient_ad_list	住院清單
patient_ad_note	住院病歷
patient_drug_list	用藥清單
patient_drug_content	用藥詳細
patient_consult_list	會診清單
patient_consult_note	會診內容
patient_scaned_note	掃描病歷

Surgery (3)

Tool	說明
surgery_doc_schedule_list	醫師手術排程
surgery_dept_schedule_list	科別手術排程
surgery_schedule_detail	手術詳細

Doctor (4)

Tool	說明
doc_opd_patient_list_previous	過去看診名單 (僅限過去日期)
doc_opd_schedule	未來門診清單
doc_opd_patient_list_appointment	掛號名單
doc_batch_opd_note	批次門診病歷 (含防護機制)

Consent (4)

Tool	說明
consent_opschedule	手術排程
consent_list	同意書清單
consent_search	搜尋同意書
consent_pdf_bytes	下載 PDF

IVI (1)

Tool	說明
ivi_fetch_schedule	IVI 排程

回傳格式

{
  "success": true,
  "data": [...],
  "message": "",
  "count": 15
}

專案結構

vghsdk-mcp/
├── vghsdk_mcp.py      # FastMCP 入口
├── pyproject.toml
└── vghsdk/
    ├── core.py        # SessionManager, VghClient
    ├── utils.py       # 日期轉換
    └── tools/         # 27 個 MCP Tools
        ├── patient.py
        ├── surgery.py
        ├── doctor.py
        ├── consent.py
        └── ivi.py

測試

MCP Inspector

npx @modelcontextprotocol/inspector uv --directory /path/to/vghsdk run python -m vghsdk_mcp

授權

Private - Internal Use Only

作者

ZMH