文章目錄
Key Takeaways
- 免除本機基礎設施負擔:開發者無須自行建置 PostgreSQL 與向量資料庫,直接透過 Streamable HTTP 端點即可將台灣醫療資訊整合至大型語言模型。
- 支援主流 MCP 客戶端生態:全面相容 Claude Code、Claude Desktop、Cursor 等開發環境,一行指令即可完成工具宣告與載入。
- 打通台灣藥品與 FHIR 標準:內建食藥署藥品許可證資料庫與外觀特徵索引,支援將查詢結果自動映射為國際標準 FHIR R4 Medication 結構。
- 雙軌部署架構:提供免設定的公有端點進行概念驗證(PoC),同時完整開源 Docker 部署腳本,滿足醫療院所對資安防護與內網隔離的嚴格規範。
為什麼醫療 AI 開發需要專屬的 Context Protocol?
在過去,當開發者嘗試讓 Claude 或其他 AI Agent 協助處理台灣醫療場景的任務時,經常面臨幾個關鍵痛點:
- 藥品代碼與本土商品名脫節:通用語言模型對台灣本土藥品商品名(如「普拿疼肌立」、「合利他命」)或健保代碼缺乏最新索引,容易產生幻覺。
- 資料格式不符合國際醫療標準:模型輸出的藥物建議多為非結構化文字,無法直接寫入電子病歷(EMR)或對接臨床 FHIR 伺服器。
- 本機部署維護成本高昂:若要讓 Agent 查詢官方藥品資料,開發者得自行抓取食藥署 Open Data、建立全文檢索與 pgvector 向量庫,並持續追蹤仿單更新。
為了解決這些問題,療心智能團隊開源了 Taiwan Health MCP,並正式開放免架設的線上公開端點,讓醫療科技開發者能專注於打造 Agentic Workflow 與臨床應用,無須分心於繁雜的資料管線維護。
線上端點開放工具清單(v0.1.0)
Taiwan Health MCP 線上端點目前開放 10 項核心工具,劃分為四大模組:
| 模組分類 | 工具名稱 (Tool) | 臨床與開發應用場景 |
|---|---|---|
| 藥品檢索 | search_drug | 依據中文品名、英文品名、主成分或許可證字號檢索台灣藥品 |
| 藥品檢索 | identify_unknown_pill | 依據藥丸外觀特徵(形狀、顏色、刻痕、標記)辨識不明處方藥 |
| 藥品檢索 | get_drug_details | 提取單一藥品之完整適應症、用法用量、警語與仿單內容 |
| 藥品檢索 | get_drug_asset_links | 取得藥品外觀照片與衛福部核定仿單 PDF 原檔連結 |
| FHIR 標準轉換 | query_fhir_medication | 將台灣藥品資料自動轉換為標準 FHIR R4 Medication 結構 |
| FHIR 標準轉換 | validate_fhir_medication | 驗證輸入之 Medication JSON 是否符合 FHIR R4 規格定義 |
| 外部伺服器管理 | list_fhir_servers | 檢視系統管理員所配置之機構外部 FHIR 伺服器清單 |
| 外部伺服器管理 | get_fhir_server_status | 檢測目標 FHIR 伺服器之連線延遲與權限狀態 |
| 外部伺服器管理 | crud_fhir_server | 對特定 FHIR 伺服器執行安全的資源讀寫調度 |
| 系統監控 | health_check | 確認 MCP 核心服務與後端檢索管線之運作狀態 |
快速設定指引:3 分鐘完成整合
方法一:在 Claude Code (CLI) 中快速載入
開啟終端機,執行以下指令建立 HTTP 傳輸連線:
claude mcp add --transport http tw-health-mcp https://tw-health-mcp.healthymind-tech.com/mcp
驗證連線狀態:
claude mcp list
當看到 ✔ Connected tw-health-mcp 標記時,即表示工具載入完成。隨後即可在對話中直接發出查詢請求:
幫我查詢「普拿疼肌立水性酸痛藥布」的許可證字號、主成分與適應症,並將結果輸出為 FHIR Medication 格式。
方法二:在 Claude Desktop 中配置
若使用桌面版 Claude,請在設定檔 claude_desktop_config.json 中加入伺服器宣告:
- macOS 設定路徑:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows 設定路徑:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"tw-health-mcp": {
"type": "http",
"url": "https://tw-health-mcp.healthymind-tech.com/mcp"
}
}
}
存檔並重啟 Claude Desktop 後,對話視窗右下角將出現工具啟用圖示。
方法三:在 Cursor / Windsurf 等 IDE 中使用
在 IDE 的 MCP 設定面板中新增 Custom Server:
- Server Type:
HTTP / SSE - Server URL:
https://tw-health-mcp.healthymind-tech.com/mcp
實際呼叫範例與資料回傳結構
範例:不明藥物特徵辨識與成分檢索
當患者或長輩手中有散裝藥丸但遺失藥袋時,可透過外觀特徵進行精準比對:
使用者提問:
我有一顆圓形、白色、中間有一道刻痕、上面印有「Y-P」字樣的藥丸,請幫我查詢可能是什麼藥?
AI Agent 呼叫 identify_unknown_pill 工具後,後端將返回匹配之候選藥品清單與許可證資訊,協助醫事人員或個管師進行快速核對。
醫療機構與企業自建部署方案
針對需要處理機敏病歷資料、遵循 HIPAA 或台灣個人資料保護法之醫療院所,建議採用地端私有化部署架構。
[院內 HIS / 護理系統]
↓
[Claude / 院內私有 LLM]
↓ (內網呼叫)
[Taiwan Health MCP Server (Docker)]
↓
[PostgreSQL + pgvector (台灣食藥署本地資料庫)]
部署步驟
# 取得開源專案程式碼
git clone https://github.com/healthymind-tech/Taiwan-Health-MCP
cd Taiwan-Health-MCP
# 設定環境變數
cp .env.example .env
# 啟動容器服務
docker compose up -d
啟動後,地端 MCP 服務將監聽 http://localhost:8080/mcp。
地端環境需求
- 資料庫:PostgreSQL 16(需載入
pgvector延伸模組以支援語意檢索) - 快取層:Redis 7+
- 資產儲存:MinIO 或 S3 相容物件儲存(存放仿單與藥物外觀圖檔)
- 執行環境:Node.js 20+ 與 Docker Compose 2.0+
開源共創與後續發展規劃
Taiwan Health MCP 採用寬鬆的 MIT 開源授權,專案原始碼完整公開於 GitHub:
👉 GitHub 專案庫:https://github.com/healthymind-tech/Taiwan-Health-MCP
後續版本將依據臨床需求陸續擴充以下功能模組:
- 台灣 ICD-10-CM 診斷代碼智慧對照引擎
- LOINC 檢驗檢查項目與參考值查詢
- 台灣全民健保給付規定與適應症檢核規則庫
若您的團隊在醫療院所整合、FHIR 資料交換或 DietMate 臨床營養 AI 平台 導入上有評估需求,歡迎隨時與我們的臨床工程團隊聯繫。
相關文章推薦:




討論區 (0 則留言)