Taiwan-Health-MCP

- 台灣在地化資料：台灣 FDA 藥品（含仿單 / 外觀 / OCR + LLM 分析）、健康補充品、食品營養、TWCore IG。
- 國際術語支援：ICD-10-CM/PCS 2025、SNOMED CT International、LOINC 2.80、FHIR R4。
- FHIR IG 授權工具：多 IG（package-scoped）剖面 / ValueSet 查詢、術語驗證、骨架填值（skeleton-fill）資源產生與驗證。
- 語意 / 混合搜尋：以嵌入模型（預設 Ollamaqwen3-embedding）為基礎，無嵌入時自動退回關鍵字搜尋。
- 動態工具啟用：依各模組資料載入狀態自動註冊 / 移除可用 MCP 工具。
- 管理後台：可選的 Admin Console（上傳來源檔、執行 / 排程匯入、管理設定與外部 FHIR 伺服器、即時監控背景工作）。
- 生產部署設計：PostgreSQL 16（pgvector）、pgBouncer、Redis、MinIO、Prometheus、背景 worker，前置 nginx 單一入口。

工具顯示為 available 只代表來源資料已載入，不代表 embedding 已完整。請在 Admin → Modules 檢查各模組的 Embeddings 計數；未完成時搜尋會退回或混用 keyword/BM25。

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

docker compose build app web && docker compose up -d --no-deps app web

ADMIN_ENABLED=true ADMIN_USERNAME=admin # 產生密碼雜湊（Node；本專案已無 Python 相依）： # node -e "console.log('sha256$' + require('crypto').createHash('sha256').update('change-me').digest('hex'))" # ⚠️ 在 .env 中，每個 $ 都要寫成 $$（Docker Compose 會把 $ 當變數展開， # 當雜湊值以字母開頭時會被靜默截斷）。Compose 會把 $$ 還原成單一 $。 ADMIN_PASSWORD_HASH=sha256$$... ADMIN_SESSION_SECRET=change_this_admin_session_secret

嵌入（語意搜尋）為獨立的_embed工作，可於各模組頁面執行。嵌入 / OCR / 分析 LLM 的端點在Settings頁籤設定（存於admin.llm_profiles，不透過環境變數）。

模組相關工具會依資料載入狀態自動啟用 / 停用；FHIR 伺服器與系統工具則永遠註冊。

除crud_fhir_server外，所有工具皆為唯讀。crud_fhir_server可對已由管理者登錄的外部 FHIR 伺服器執行寫入（create / update / patch / delete），且必須該伺服器的 allow-list 允許、呼叫端並帶入confirm_write=true。

/openapi.json依「目前已啟用的工具」動態產生 OpenAPI 3.1 規格；每個工具對應POST /tools/<工具名>，以 JSON body 當參數呼叫。客戶端只要填基底網址http://<host>:8080，即會自動抓取/openapi.json。

注意：這兩個介面目前皆未強制驗證（與既有設計一致）；對外開放時請在前面加反向代理或 token。

audit|admin|icd|drug|health_supplements|food_nutrition|loinc|fhir（multi-IG）|snomed|rxnorm

完整定義見db/schema.sql（PostgreSQL 容器首次啟動時自動套用），增量變更見db/migrations/。

# 後端（MCP + admin REST + worker） cd node-server npm install npm run build # tsc -> dist/ npm run typecheck # tsc --noEmit npm test # node --test（node-server/src/*/.test.ts） # 前端（管理後台 SPA） cd web npm install npm run build npm run typecheck

- 台灣衛生福利部、TFDA
- Regenstrief Institute（LOINC）
- SNOMED International
- National Library of Medicine（RxNorm / UMLS）
- HL7 International（FHIR）
- WHO

Unified access to global medical terminologies: ICD-11, SNOMED CT, LOINC, RxNorm, MeSH. 27 tools for medical coding, terminology lookup, and crosswalk mappings.

Medical terminology intelligence for AI agents — ICD-10-CM lookup, MedDRA hierarchy and SOC mapping, RxNorm drug concepts, CTCAE v5.0 grading, and cross-terminology mapping.

Structured aquarium, marine, terrarium and paludarium data for AI agents.

Bioinformatics data for AI agents — gene search, protein structures, clinical variants, PubMed literature, and DNA sequences via NCBI and UniProt. No API key required.

Free hypertrophy knowledge base - based exclusively on scientific papers.

Pharmacovigilance intelligence — 165 tools for drug safety data (FDA FAERS, EudraVigilance, WHO, PubMed, ClinicalTrials.gov), signal detection (PRR/ROR/IC/EBGM), causality assessment, and guided research courses. Open, no auth required.

MCP server providing tools to access EFSA's comprehensive OpenFoodTox Chemical Hazards in food dataset

NIH clinical trials and FDA adverse event reports. 4 MCP tools for health research.