Skip to content

v0.1.0 - Initial Beta Release

Pre-release
Pre-release

Choose a tag to compare

View all tags
@brianshen0522 brianshen0522 released this 02 Aug 15:50
· 19 commits to main since this release
v0.1.0
9dd6ad4

Taiwan Health MCP Server — v0.1.0 (Beta)

台灣醫療健康資料整合 MCP 伺服器，首個 Beta 版本。

以官方 TypeScript MCP SDK 建構的 Node.js 服務，對外提供 49 個工具（11 個工具群組），
整合 ICD-10-CM/PCS、SNOMED CT、LOINC、台灣 FDA 藥品／健康補充品／食品營養資料，
以及 FHIR R4 IG 授權與驗證工具。專為高吞吐量的生產級 SaaS 部署設計。

⚠️ Beta 版本說明：API 與工具介面在正式 v1.0 前仍可能調整。歡迎回報問題與建議。

核心能力

領域 內容
ICD-10-CM/PCS 診斷／手術碼搜尋、鄰近碼、分類瀏覽、併發症推論、衝突檢查
LOINC 檢驗項目搜尋、參考區間、單筆／批次檢驗判讀
SNOMED CT 概念搜尋、關聯查詢、SNOMED ↔ ICD-10 對應
台灣 FDA 藥品 藥名／成分／許可證號／ATC 搜尋、外觀辨識、OCR + LLM 仿單分析
健康補充品／食品營養 關鍵字與病症對應搜尋、營養素查詢、餐點營養分析
FHIR R4 Condition / Medication 產生與驗證
FHIR IG（多 IG） 剖面／ValueSet 查詢展開、術語驗證、骨架填值資源產生與驗證（預設 TWCore v1.0.0）
FHIR 伺服器 外部伺服器登錄、狀態查詢、受控寫入（allow-list + confirm_write）

架構

  • 後端 100% Node.js / TypeScript（node-server/），已完全移除 Python 相依
  • 前端 Next.js（公開頁面 + /admin 管理後台 SPA）
  • PostgreSQL 16（pgvector）+ pgBouncer + Redis + MinIO + Prometheus，nginx 單一對外入口
  • 動態工具註冊：依各模組資料載入狀態自動啟用／停用工具
  • 語意 / 混合搜尋：嵌入模型強化，無嵌入時退回關鍵字

快速開始

git clone https://github.com/healthymind-tech/Taiwan-Health-MCP.git
cd Taiwan-Health-MCP
cp .env.example .env
docker compose up -d

詳見 Getting Started。

本版重點變更

  • 後端完成從 Python 到 Node.js / TypeScript 的全面遷移
  • 移除臨床指引（Clinical Guideline）模組（設計未成熟，將以 POC 重新規劃後再實作）
  • 文件全面審查，修正過時引用（舊工具數量、舊 Python 檔名等）

完整變更歷史見 CHANGELOG.md。

已知限制

  • 中文關鍵字搜尋在未執行 embedding 時效果有限（Postgres simple tokenizer 限制），建議設定嵌入模型（預設 Ollama）
  • 除 crud_fhir_server 外所有工具皆為唯讀；crud_fhir_server 寫入僅限管理者已登錄且 allow-list 允許的外部 FHIR 伺服器
  • FHIR IG 內建驗證引擎非官方 HL7 FHIR Validator 的一致性認證等級
Assets 2
Loading