Taiwan Health MCP Server

🇹🇼 台灣醫療健康資料整合 MCP 伺服器 整合 ICD-10-CM、SNOMED CT、RxNorm、LOINC、FDA 藥品/保健食品/營養、TWCore IG、臨床指引，支援 FHIR R4 標準

• 🇹🇼 台灣在地化 — 整合台灣 FDA、衛福部官方開放資料，支援繁體中文
• 🔗 國際標準 — 符合 FHIR R4、ICD-10-CM 2025、LOINC 2.80、SNOMED CT、RxNorm、ATC
• 🏥 56 個 MCP 工具 — 涵蓋診斷、藥品、檢驗、指引、術語、藥物交互作用
• 🏗️ 生產就緒 — PostgreSQL 16 + pgBouncer + Redis + Prometheus，支援每秒數百請求
• 🔄 自動同步 — FDA 藥品/保健食品/營養資料每週自動更新

• Docker + Docker Compose
• 至少 4 GB 可用記憶體

git clone https://github.com/healthymind-tech/Taiwan-Health-MCP.git
cd Taiwan-Health-MCP
cp .env.example .env
cp config/datasets.example.yaml config/datasets.yaml
# 編輯 .env，至少設定 POSTGRES_PASSWORD
# 視部署環境編輯 config/datasets.yaml，指定各 dataset 的實際檔案位置

docker compose up -d

這會啟動四個容器：postgres、pgbouncer、redis、app（MCP server）。

術語資料（ICD、LOINC、SNOMED CT 等）需手動下載後，在 config/datasets.yaml 設定檔案位置，再執行 loader：

# 全部載入（建議首次部署）
docker compose --profile loader run --rm data-loader --all

# 僅初始化 FDA 動態資料
docker compose --profile loader run --rm data-loader --fda
docker compose --profile loader run --rm data-loader --drug
docker compose --profile loader run --rm data-loader --health-food
docker compose --profile loader run --rm data-loader --food-nutrition

# 或依需求單項載入
docker compose --profile loader run --rm data-loader --icd        # ICD-10-CM 2025
docker compose --profile loader run --rm data-loader --loinc      # LOINC 2.80
docker compose --profile loader run --rm data-loader --twcore     # TWCore IG
docker compose --profile loader run --rm data-loader --guideline  # 臨床指引
docker compose --profile loader run --rm data-loader --snomed     # SNOMED CT（5-15 分鐘）
docker compose --profile loader run --rm data-loader --rxnorm     # RxNorm

DATASETS_CONFIG 預設為 /app/config/datasets.yaml。若未設定，loader 會回退到舊的 /app/fhir-code 目錄規則。新部署建議使用 config/datasets.yaml，避免依賴固定檔名與固定目錄結構。

--all 現在也會初始化 Taiwan FDA 藥品、健康食品、營養資料。 app 仍會在首次啟動或資料過期時自動同步，但若想在部署階段先灌資料，請使用 data-loader --all 或 --fda。

# 查看服務狀態
docker compose ps

# 健康檢查（需先建立 MCP session）
curl http://localhost:8000/mcp -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}'

在 claude_desktop_config.json 加入：

{
  "mcpServers": {
    "taiwan-health": {
      "url": "http://localhost:8000/mcp",
      "transport": "streamable-http"
    }
  }
}

audit | icd | drug | health_food | food_nutrition | loinc | guideline | twcore | snomed | rxnorm

• 健康食品疾病對應 — 開發者整理，未經醫學驗證，不適合直接面向患者
• FHIR 驗證 — 僅檢查必要欄位；生產環境請使用 HL7 FHIR Validator
• ICD-10-PCS — 已內建 2025 版（78,948 筆），--icd 自動同時載入 CM 和 PCS；icd.procedures 未載入時工具自動降級
• SNOMED CT — 需有效的 SNOMED International 授權（多數用途免費）
• 藥物交互作用 — RxNorm interacts_with 不含嚴重程度評級，須由臨床醫師確認
• pgBouncer transaction mode — 不相容於 LISTEN/NOTIFY 和 named prepared statements（asyncpg 已設 statement_cache_size=0）

歡迎貢獻！詳見 CONTRIBUTING.md。

主要需求：

• 補充/驗證臨床指引種子資料
• 新增 LOINC 中文對照
• 補充健康食品疾病對應（需醫學審核）
• 補充/驗證臨床指引種子資料

• GitHub Issues: 回報問題
• Email: support@healthymind-tech.com

Made with contrib.rocks.

• 台灣衛生福利部、TFDA（ICD、藥品、健康食品、營養資料）
• Regenstrief Institute（LOINC）
• SNOMED International（SNOMED CT）
• National Library of Medicine（RxNorm、ICD-10-CM）
• HL7 International（FHIR）
• WHO（ICD、ATC）
• Twinkle AI — 感謝社群串接本專案打造 Twinkle Health Agent

⭐ 如果這個專案對您有幫助，請給我們一個 Star！