文章目錄
一句話總結:Taiwan Health MCP 是一套讓 AI 能安全存取台灣醫療資料的開源工具集——包含 ICD-10 疾病碼查詢、藥品資料、LOINC 檢驗碼等 32 個工具,全部支援 MCP 協定,本地端執行,MIT 授權。
Key Takeaways
- MCP(Model Context Protocol)是 Anthropic 2024 年底推出的開放協定,讓 AI 能用標準化方式呼叫外部工具
- Taiwan Health MCP 解決的是具體問題:台灣醫療有自己的 ICD-10 版本、藥品編碼、法規,全球通用的 MCP Server 不包含這些
- 32 個工具分四類:疾病碼、藥品、檢驗標準、FHIR R4 對接——開發者可以只用需要的部分
- 三行指令就能跑起來,不需要雲端帳號,資料查詢在本機完成
- 這是開源基礎建設,不是商業產品,歡迎直接 fork 和貢獻
MCP 是什麼?
MCP(Model Context Protocol)是 Anthropic 在 2024 年 11 月推出的開放協定。它規定了 AI 模型和外部工具之間的溝通格式——哪些工具存在、怎麼呼叫、參數長什麼樣、回傳格式如何。
沒有 MCP 之前,如果你要讓 Claude 或 GPT 去查一個資料庫,你需要自己寫 Function Calling 的 schema,自己做認證,自己處理格式轉換。每個 AI 應用都在重複這件事,方式各不相同。
MCP 的比喻:想像 USB-C 標準化之前,每個品牌的充電線都不一樣;USB-C 出來之後,不管接什麼裝置,一條線就夠了。MCP 對 AI 工具呼叫做的事情差不多——定義一個所有人都照著走的標準,讓工具和 AI 之間的整合變成設定問題,而不是工程問題。
技術上:MCP 是 JSON-RPC 2.0 協定,支援 stdio 和 SSE 兩種傳輸方式。Client(AI 應用)可以在 runtime 動態查詢 Server 有哪些工具,不需要提前寫死。
Taiwan Health MCP 的 32 個工具
這套系統的工具分四個大類,以下是詳細說明:
疾病診斷碼(ICD-10)
| 工具 | 功能 | 為什麼需要台灣版 |
|---|---|---|
icd10_search | 關鍵字搜尋疾病碼 | 台灣健保申報用的 ICD-10-CM/PCS 2025 有本土化修訂版本 |
icd10_lookup | 精確碼號查詢與說明 | 同一個疾病在 WHO 版和台灣健保版的分類有時不一致 |
icd10_hierarchy | 查詢碼的上下層結構 | 病歷 QA 和申報審查需要理解碼的分類邏輯 |
icd10_validate | 驗證碼格式是否有效 | 防止申報錯誤 |
醫院的病歷 QA 部門最常用這幾個工具,尤其是主診斷碼和次診斷碼的確認。
藥品資料(食藥署)
| 工具 | 功能 |
|---|---|
drug_search | 搜尋食藥署核准藥品 |
drug_lookup | 查詢藥品許可證詳細資訊 |
drug_interactions | 檢查藥物交互作用 |
drug_ingredients | 查詢成分與含量 |
drug_warnings | 查詢警語與禁忌 |
這些工具查的是台灣 FDA 的藥品資料,不是美國 FDA 或 WHO 的。台灣核准的藥品品項、許可證號、中文藥名,跟國際資料庫對不上的情況很常見。
檢驗標準(LOINC)
| 工具 | 功能 |
|---|---|
loinc_search | 搜尋 LOINC 標準碼 |
loinc_lookup | 查詢碼的完整定義 |
lab_reference_ranges | 查詢台灣常用參考值範圍 |
lab_units_convert | 單位換算(例如 mmol/L ↔ mg/dL) |
LOINC 2.80 是目前最新版本,這套工具讓 AI 可以把醫院自訂的檢驗碼對應到標準 LOINC 碼,是跨院資料整合的基礎。
FHIR R4 標準介面
Taiwan Health MCP 的 FHIR R4 模組是這套系統裡技術含量最高的部分:
| 工具 | 功能 |
|---|---|
fhir_patient_read | 讀取病患基本資料 |
fhir_observation_search | 查詢觀察值(檢驗結果、生命徵象等) |
fhir_medication_request | 讀取用藥記錄 |
fhir_condition_list | 列出病患診斷清單 |
fhir_validate_resource | 驗證 FHIR Resource 格式 |
這五個工具連的是院內的 FHIR R4 Server,需要你自己的醫院已經建置 FHIR 介面(或使用支援 FHIR 的 HIS 系統)。
其他工具
- 台灣食品營養資料庫:查詢食品熱量、三大營養素、微量元素,資料來源是國健署公開資料集
- 臨床指引搜尋:查詢台灣各醫學會發布的治療指引
- SNOMED CT 對應:把 ICD-10 碼對應到 SNOMED CT 概念
為什麼台灣醫療需要這個?
一個具體的場景說明問題在哪:
某家醫院的 IT 部門想做一個 AI 助理,讓病歷編碼員輸入疾病名稱、自動建議 ICD-10 碼。需求很簡單,但實作起來要解決幾個問題:
- 台灣健保申報用的 ICD-10-CM/PCS 版本跟 WHO 原始版有差異,不能直接用國際資料庫
- 同一個疾病可能有多個合法的碼,要考慮主診斷和次診斷的配對規則
- 查詢結果要讓 AI 能理解並解釋,不能只是回傳碼號
要自己做,需要:爬食藥署資料、清理格式、寫 API、測試準確性。每個醫院的 IT 部門都在做這件事,方法各不相同,品質也參差不齊。
Taiwan Health MCP 把這一層統一做好、開源出去。醫院的工程師接上去就能用,不需要重新造輪子。這是這個專案存在的理由——不是要取代醫院的系統,而是把「讓 AI 能查台灣醫療資料」這件事變成可以直接取用的基礎建設。
如何開始使用?
開發者:三行指令跑起來
# Clone 專案
git clone https://github.com/healthymind-tech/Taiwan-Health-MCP
# 安裝依賴
cd Taiwan-Health-MCP
npm install
# 啟動 MCP Server
npm start
Server 預設跑在 stdio 模式,適合接 Claude Desktop。如果要開 HTTP/SSE 模式讓多個 Client 連,改設定檔就好,README 有說明。
接上 Claude Desktop
在 ~/Library/Application Support/Claude/claude_desktop_config.json 加入:
{
"mcpServers": {
"taiwan-health": {
"command": "node",
"args": ["/path/to/Taiwan-Health-MCP/src/index.js"]
}
}
}
重啟 Claude Desktop,側邊欄就會出現工具圖示,可以直接開始用自然語言查 ICD-10、藥品等資料。
Docker 方式
docker compose up -d
適合要跑在伺服器上的場景,不需要本機安裝 Node.js。
醫療機構:評估和導入
Taiwan Health MCP 可以和院內系統整合,但這需要規劃。建議的路徑:
- 先在沙盒環境測試:確認工具的查詢結果符合院內使用規範(尤其是 ICD-10 版本對應)
- 小規模試行:選一個不直接影響臨床流程的場景,例如病歷 QA、教學用途
- 系統整合:如果要接 FHIR R4,需要 IT 部門和資安部門確認
如果你正在評估導入,或想把 Taiwan Health MCP 跟 DietMate AI 營養照護平台 整合使用,我們提供技術諮詢。FHIR R4 對接和客製化工具開發可以討論。
開源與社群
Taiwan Health MCP 採 MIT 授權,可以自由使用、修改、商業應用。
- GitHub:github.com/healthymind-tech/Taiwan-Health-MCP
- 貢獻方式:Issue 回報問題、Pull Request 新增工具或修正資料、Discussion 討論使用場景
- 授權:MIT License,詳見 GitHub 上的 LICENSE 文件
台灣的醫療資料標準會持續更新(ICD-10 每年有小改版、食藥署資料庫也會更新),歡迎有能力的工程師一起維護這份資料。這是公共基礎建設,單靠一個團隊維護的邊際成本太高。
相關文章:Taiwan Health MCP 線上版使用指南 · 開源揭幕(一)|Taiwan Health MCP 的誕生 · MCP FAQ:醫療 AI 開發者最常問的 13 個問題 · MCP × FHIR R4 實戰指南 · Agentic Healthcare Workflow





討論區 (0 則留言)