vghsdk-mcp

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