T
Taiwan Health MCP
讓 AI agent 讀懂台灣醫療：63 個 MCP 工具，涵蓋 FHIR R4 / TW Core 驗證、ICD-10、SNOMED CT、LOINC、TFDA 藥品與臨床計算器。MCP server for Taiwan healthcare data.
Install Taiwan Health MCP
Pick your client, then add it in one click or paste the config.
No confirmed install command yet
We only publish a config when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for Taiwan-Health-MCP, and we’d rather show nothing than a guess you’d paste into your client.
Open setup steps on GitHubOverview
From the project README
Taiwan Health MCP Server
繁體中文 · English
台灣醫療健康資料整合 MCP 伺服器
整合 ICD-10-CM/PCS、SNOMED CT、LOINC、台灣 FDA 藥品 / 健康補充品 / 食品營養，以及 FHIR R4 IG 授權與驗證工具
https://github.com/user-attachments/assets/13527dd9-72ac-4e36-9868-7967399d4041
以官方 TypeScript MCP SDK（@modelcontextprotocol/sdk）建構的 Node.js 伺服器，對外提供 63 個工具，涵蓋 12 個工具群組。專為高吞吐量的生產級 SaaS 部署設計。
快速連線
不想自己架設，可以直接連官方端點 https://tw-health-mcp.healthymind-tech.com/mcp（MCP streamable-http）。
Claude Code
claude mcp add --transport http taiwan-health https://tw-health-mcp.healthymind-tech.com/mcp
Claude Desktop / claude.ai：在「設定 → 連接器」新增自訂連接器，貼上上面的端點網址。
其他支援 MCP streamable-http 的客戶端，填入同一個網址即可。要在自己的環境部署，請看自行部署。
六大面向
|
FHIR Box 連接 · 3 個工具 管理者登錄院內 FHIR Box 或任何 FHIR R4 伺服器後，AI agent 就能查詢與讀取資源
|
TW IG 驗證與 grounding · 26 個工具 多 IG 剖面與 ValueSet、骨架填值產生資源、對齊 HL7
|
台灣藥品與營養 · 9 個工具 TFDA 藥品許可證、仿單 OCR、依刻字 / 顏色 / 外型辨識藥丸，加上健康食品與食品營養成分
|
|
國際語彙 · 13 個工具 ICD-10-CM / PCS（CMS 2026-04-01）、SNOMED CT International、LOINC 2.80 與 RxNorm：查碼、跨語彙映射、解讀檢驗值
|
臨床計算器 · 11 個工具 CHA₂DS₂-VASc、Wells、HAS-BLED、CURB-65、qSOFA、GCS、eGFR、DAS28、CDAI、BMI（台灣切點）；確定性計算，不讓 LLM 自己算
|
語意搜尋 · 跨模組 ICD-10、LOINC、SNOMED CT 與 IG CodeSystem 以 pgvector 嵌入（預設 Ollama
|
全部 63 個工具
| 群組 | 工具 |
|---|---|
| ICD-10 | search_medical_codes、infer_complications、get_nearby_codes、check_medical_conflict、browse_icd_category |
| 藥品 / TFDA | search_drug、identify_unknown_pill、get_drug_details、get_drug_asset_links |
| 檢驗 / LOINC | search_loinc、query_loinc、interpret_lab_result、batch_interpret_lab_results |
| SNOMED CT | search_snomed_concept、query_snomed_concept、get_snomed_relationships、query_snomed_mapping |
| FHIR Condition | query_fhir_condition、validate_fhir_condition |
| FHIR Medication | query_fhir_medication、validate_fhir_medication |
| FHIR IG（授權 / 驗證） | fhir_list_igs、fhir_get_ig、fhir_list_artifacts、fhir_search_artifacts、fhir_list_resource_profiles、fhir_rank_resource_profiles、fhir_get_profile、fhir_get_profile_elements、fhir_get_profile_required_elements、fhir_get_valueset、fhir_expand_valueset、fhir_lookup_code、fhir_validate_code、fhir_normalize_code、fhir_resolve_reference、fhir_build_bundle、fhir_validate_resource、fhir_validate_bundle、fhir_get_resource_skeleton、fhir_finalize_resource、fhir_check_grounding、fhir_check_completeness |
| 健康補充品 | search_health_supplements |
| 食品營養 | query_food_nutrition、query_food_ingredient、search_foods_by_nutrient、analyze_meal_nutrition |
| FHIR 伺服器 | list_fhir_servers、get_fhir_server_status、crud_fhir_server |
| 臨床計算器 | calculate_chads2_vasc、calculate_wells_pe、calculate_wells_dvt、calculate_das28、calculate_cdai、calculate_bmi、calculate_egfr、calculate_has_bled、calculate_curb65、calculate_qsofa、calculate_gcs |
| 系統 | health_check |
- 模組相關工具會依資料載入狀態自動啟用 / 停用（例如健康補充品、食品營養未載入時，
/openapi.json只會列出 58 個）；FHIR 伺服器、臨床計算器與系統工具則永遠註冊。管理後台「MCP 工具」頁（/admin/mcp）列出全部 63 個工具、未註冊的原因，並可線上試呼叫。 - 除
crud_fhir_server外，所有工具皆為唯讀。crud_fhir_server可對已由管理者登錄的外部 FHIR 伺服器執行寫入（create / update / patch / delete），且必須該伺服器的 allow-list 允許、呼叫端並帶入confirm_write=true。 - 工具顯示為 available 只代表來源資料已載入，不代表 embedding 已完整。請在管理後台各模組頁（如「醫療術語」底下的 ICD-10 / LOINC / SNOMED）檢查 Embeddings 計數；未完成時搜尋會退回或混用 keyword/BM25（回應會標
search_mode: "keyword_only"）。 - 術語範圍：ICD-10-CM（CMS 2026-04-01 完整碼表，含第 7 碼）/ ICD-10-PCS、WHO ICD-10（選用）、SNOMED CT International（含 inactive 內容與歷史關聯）、LOINC 2.80（含 answer / part / panel）、RxNorm、FHIR R4；內建 validator 另支援 CVX、ISO 3166、UCUM。Validator 稽核見
node-server/scripts/validator-audit/。
架構
flowchart LR
subgraph clients["客戶端"]
agent["AI agent<br/>Claude · ChatGPT · Cursor"]
openapi["OpenAPI 客戶端<br/>Open WebUI"]
admin["管理者"]
end
subgraph stack["docker compose"]
nginx["nginx :8080<br/>單一入口"]
app["app<br/>MCP server + 管理 API"]
web["web-v2<br/>管理後台 SPA"]
worker["admin-worker<br/>匯入與嵌入"]
pg[("PostgreSQL 16 + pgvector<br/>經 pgBouncer")]
redis[("Redis<br/>即時事件")]
minio[("MinIO<br/>來源檔與藥品資產")]
nginx --> app
nginx --> web
app --> pg
worker --> pg
app <--> redis
worker <--> redis
worker --> minio
end
agent -- "/mcp" --> nginx
openapi -- "/openapi.json · /tools/*" --> nginx
admin -- "/admin" --> nginx
worker -.-> ext["嵌入模型 · OCR · Analysis LM<br/>TFDA Open Data"]
app -.-> fhir["外部 FHIR 伺服器"]
- 後端全部是 Node.js / TypeScript（
node-server/）：app提供 MCP 與管理 API，admin-worker執行所有匯入與嵌入工作。本專案已無 Python 執行期相依。 - 管理後台是 Vite + React + Mantine 的 SPA（
web-v2/）；舊的 Next.jsweb/只留在 compose profilelegacy-web供回滾。 - 工具依各模組資料載入狀態自動註冊；嵌入模型無法連線時，搜尋自動退回關鍵字。
- 指標以 Prometheus 格式輸出（
METRICS_PORT，預設只綁 localhost）。 - 宣傳頁與法務頁（
/、/status、/privacy、/dpa）由獨立的官網提供，不在本專案。
自行部署
git clone https://github.com/healthymind-tech/Taiwan-Health-MCP.git
cd Taiwan-Health-MCP
cp .env.example .env # 設定 POSTGRES_PASSWORD、ADMIN_* 等
docker compose up -d
啟動後 MCP 端點是 http://<host>:8080/mcp，到 http://<host>:8080/admin 登入管理後台匯入資料。完整說明見部署指南。
啟動的服務與重新部署
| 服務 | 說明 |
|---|---|
nginx | 單一對外入口，預設 :8080（WEB_PORT） |
web-v2 | 管理後台 SPA（Vite 靜態檔，由容器內 nginx 提供）；前門把 /admin 與其餘頁面導到這裡 |
app | Node MCP 伺服器 + 管理後台 REST API（node dist/server.js；只在內部網路，不對主機開埠） |
admin-worker | 背景工作執行器（所有匯入與嵌入工作，node dist/admin/adminWorker.js） |
postgres | PostgreSQL 16 + pgvector |
pgbouncer | 連線池（transaction mode） |
redis | 管理後台即時事件的 pub/sub 轉送與健康檢查；目前沒有任何工具回應被快取 |
minio + minio-init | 物件儲存（管理後台上傳的來源檔、藥品資產） |
舊的 Next.js web 服務屬於 compose profile legacy-web，docker compose up -d 不會啟動它（僅供回滾）。
重要：
app容器不對主機開放 8000 埠，所有流量都必須經過 nginx。請一律使用http://<host>:8080（或你設定的WEB_PORT）。
程式碼變更後重新部署：
docker compose build app admin-worker web-v2 && docker compose up -d --no-deps app admin-worker web-v2
admin-worker 是另一個映像（Dockerfile.worker），只重建 app 會讓 worker 繼續跑舊的匯入程式碼。要讓 health_check 回報 git sha，建置時設定環境變數：BUILD_SHA=$(git rev-parse --short HEAD) docker compose build app admin-worker（compose.yaml 會把它當 build arg 傳入，未設定時為 dev）。
載入資料（透過管理後台）
資料匯入由 Admin Console 觸發、交由 admin-worker 背景執行（無獨立的 CLI data-loader 容器）。
-
管理後台預設啟用（
ADMIN_ENABLED=true）。在.env設定登入資訊：ADMIN_USERNAME=admin # 首次啟動時以此明文密碼建立帳密（雜湊後存入 admin.admin_credentials，之後不再覆寫； # 建立後請刪除這行，改密碼請到管理後台「帳號安全」）。 ADMIN_INITIAL_PASSWORD=change-me # 必改：仍為範例值時伺服器拒絕啟動（openssl rand -hex 32） ADMIN_SESSION_SECRET=...也可改用
ADMIN_PASSWORD_HASH（sha256$<hex>或pbkdf2_sha256$<iterations>$<salt>$<hex>；在.env中每個$要寫成$$）。啟動後（docker compose up -d），於http://<host>:8080/admin登入。 -
在各模組頁（側邊欄「醫療術語」、「藥品」、「健康食品」、「食品營養」、「IG 套件庫」）匯入資料：
Security & health
What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.
Not checked yetNo health check has run yet.
We have not completed a health check for this listing yet.
Reviews
No reviews yet — be the first to share how it worked for you.
Frequently Asked Questions about Taiwan Health MCP
We don't have a confirmed install command for Taiwan-Health-MCP yet, so we don't publish a generated one — a guessed package name would point at the wrong package or none at all. Follow the project's own README or setup instructions (https://github.com/healthymind-tech/Taiwan-Health-MCP) for the current steps.
讓 AI agent 讀懂台灣醫療：63 個 MCP 工具，涵蓋 FHIR R4 / TW Core 驗證、ICD-10、SNOMED CT、LOINC、TFDA 藥品與臨床計算器。MCP server for Taiwan healthcare data.
We don't have confirmed pricing for Taiwan-Health-MCP. Listing it on AllMCPs is free, but that says nothing about what the server itself costs — check the project's own site for current pricing.
Related MCP servers
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/taiwan-health-mcp)HTML Embed
<a href="https://allmcps.com/mcp/taiwan-health-mcp"><img src="https://allmcps.com/api/badge/taiwan-health-mcp?style=directory" alt="Taiwan Health MCP on AllMCPs" /></a>