FAQ
Taiwan Health MCP 常見問題
Taiwan Health MCP 讓 AI agent 讀懂台灣醫療：開源的 MCP server，接上 FHIR Box 與台灣語彙標準。以下回答開發者、TSP 工程師與醫院資訊室最常問的問題。
01Taiwan Health MCP 是什麼？和 FHIR Box 有什麼關係？
Taiwan Health MCP 是開源（MIT）的 Model Context Protocol（MCP）server，MCP 是讓 AI agent 以統一格式呼叫外部工具的開放協議。它提供 12 個群組、63 個工具，涵蓋 TFDA 藥品、ICD-10、SNOMED CT、LOINC、RxNorm 與 TW Core 等 FHIR IG。FHIR Box 是醫院端的 FHIR 伺服器；管理者把它登錄為外部 FHIR 伺服器後，AI agent 就能透過 list_fhir_servers、crud_fhir_server 等工具讀取資料，並用 TW Core 剖面產生與驗證資源。
02它是 FHIR Server 嗎？
不是。Taiwan Health MCP 不保存病歷資源，它是 FHIR 伺服器前面的 AI 介面層：提供術語查詢、IG 剖面與 ValueSet 查詢、資源骨架填值與驗證（以 HL7 validator_cli 7.0.1 為對齊目標），以及不靠 LLM 的病歷忠實度檢查。需要讀寫病歷時，它透過 crud_fhir_server 轉送到管理者登錄的外部 FHIR 伺服器；寫入必須在該伺服器的 allow-list 內，且呼叫端要明確帶入 confirm_write=true。
03免費嗎？怎麼收費？
程式碼以 MIT 授權開源，Community 版可自行架設、永遠免費，不限用量。開發與測試可以直接用 docker compose 在自己的電腦或伺服器啟動。由我們營運的託管服務即將推出，可先透過官網表單加入等候名單；需要 Enterprise 支援（例如 OAuth / SSO、稽核日誌、醫院地端導入協助）請來信 support@healthymind-tech.com，依部署規模報價。
04支援哪些 AI 客戶端？
任何支援 MCP streamable-http 的客戶端都能連線，例如 Claude Desktop、Claude Code（claude mcp add taiwan-health https://tw-health-mcp.healthymind-tech.com/mcp）、Cursor，以及 Open WebUI v0.6.31 以上的 MCP 連線。只支援 OpenAPI 工具伺服器的客戶端，可改用 /openapi.json 與 POST /tools/<工具名> 這組 OpenAPI bridge，兩種介面呼叫的是同一批工具。
05資料來源與版本？SNOMED CT 授權怎麼處理？
ICD-10-CM / PCS 採 CMS 2026-04-01 完整碼表，LOINC 為 2.80，另有 SNOMED CT International、RxNorm、TW Core 等 FHIR IG 與台灣 FDA 開放資料。ICD-10、LOINC、SNOMED CT、RxNorm 需要部署者自行取得來源檔，並在管理後台上傳匯入；本專案不散布這些檔案，因此 SNOMED CT 等授權由部署者依自身資格取得。各模組的載入狀態可在管理後台查看。
06會不會存病人資料？
不會。伺服器不收集個人資料，稽核紀錄只保存工具名稱、參數的 SHA-256 雜湊值、耗時與狀態，原始參數永遠不寫入日誌，因此無法從稽核紀錄還原查詢內容。唯一例外是 crud_fhir_server：呼叫端提供的資料會被轉送到管理者登錄的外部 FHIR 伺服器，本服務不保留。細節見隱私權政策與資料處理協議（DPA）。
07可以在醫院離線環境部署嗎？
可以。docker compose 會在同一台主機啟動所有元件：nginx 入口、MCP 伺服器、管理後台、背景 worker、PostgreSQL 16（pgvector）、pgBouncer、Redis 與 MinIO，沒有任何雲端相依。術語來源檔與 FHIR IG 套件（package.tgz）都能從管理後台直接上傳；語意搜尋使用本機 Ollama 嵌入模型，沒有嵌入時會自動退回關鍵字搜尋。
08MCP 端點和 OpenAPI 端點有什麼不同？
兩者提供同一批工具。/mcp 是 MCP streamable-http 端點，給原生 MCP 客戶端使用，會先握手再列出工具；/openapi.json 依目前已啟用的工具動態產生 OpenAPI 3.1 規格，每個工具對應 POST /tools/<工具名>。自架時預設不驗證，只適合可信網路；對外開放時可設定 Bearer token，三個端點會一起要求驗證。
09TSP 工程師可以用它準備實機認證嗎？
可以拿來練習認證會用到的基本功：用 SNOMED CT、LOINC、RxNorm 與 ICD-10 工具查碼與做術語映射，用 FHIR IG 工具查 TW Core 剖面、填值並驗證資源。它不是官方考試工具，也不保證通過；考試範圍與規定請以衛福部國家數位健康互通性與效能認證實驗室公告為準。
10怎麼貢獻或回報問題？
原始碼在 GitHub（https://github.com/healthymind-tech/Taiwan-Health-MCP），歡迎開 Issue 回報錯誤或提出需求，也歡迎送 Pull Request；開發規範與測試方式見文件站的 Contributing 頁。安全性問題或商務洽詢請寄 support@healthymind-tech.com。