Taiwan ICD10 Health MCP Server

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

✨ 專案特色

• 🇹🇼 台灣在地化 - 專為台灣醫療環境設計，支援繁體中文

• 🔗 標準化整合 - 符合國際 FHIR R4、LOINC、ICD-10、ATC 標準

• 📊 官方資料 - 整合台灣 FDA、衛福部官方開放資料

• 🤖 AI 整合 - 透過 MCP 協議與 Claude 無縫對接

• 🔄 持續更新 - 資料可自動同步最新資訊

🚀 快速開始

安裝

Docker 啟動（推薦）

離線部署（不連外網）

若部署環境不能連外網，請先準備好本地資料庫檔案，並啟用離線模式：

1. 預先在可連網環境啟動一次，產生資料庫檔案：

   • data/drugs.db

   • data/health_foods.db

   • data/food_nutrition.db

2. 將上述檔案與 ICD-10 Excel 一起帶到離線環境的 data/。

3. 設定環境變數 MCP_OFFLINE=true，啟動服務。

離線模式會停用資料更新排程與線上下載。

📖 完整文檔

• GitHub Pages 文檔網站 - 完整的架構、API、使用指南

• 本地 MkDocs - 離線開發文檔

📋 核心功能

1. ICD-10 診斷與手術碼查詢

• 診斷碼（ICD-10-CM）與手術碼（ICD-10-PCS）搜尋

• 診斷併發症推論

• 診斷與手術碼衝突檢查

• 轉換為 FHIR Condition 資源

2. 台灣 FDA 藥品資料整合

整合 5 個官方資料集：

• 藥品許可證（名稱、適應症、製造商）

• 藥品外觀識別（形狀、顏色、刻痕、圖片）

• 藥品成分（有效成分、含量）

• ATC 藥物分類（WHO 標準）

• 藥品仿單/說明書

• 轉換為 FHIR Medication/MedicationKnowledge 資源

3. 健康食品管理

• 台灣 FDA 核可健康食品查詢

• 健康聲稱（Health Claims）查詢

• 疾病與保健食品關聯分析

4. 營養與食品管理

• 食品營養成分查詢

• 膳食營養分析

• 食品原料/添加物查詢

5. LOINC 檢驗碼整合

• LOINC 碼對照（台灣常用 30+ 項，可擴展至 87,000+ 項）

• 檢驗參考值查詢（依年齡、性別）

• 檢驗結果自動判讀

• 批次判讀多項檢驗

6. 臨床診療指引

• 台灣醫學會臨床指引查詢

• 診斷建議、用藥建議、檢查建議

• 治療目標與臨床路徑規劃

7. FHIR R4 標準轉換

• FHIR Condition - ICD-10 診斷資源

• FHIR Medication - 藥品資源

• FHIR MedicationKnowledge - 藥品知識庫

• 符合國際醫療資訊交換標準

⚠️ FHIR 實現局限

• FHIR Condition: 核心結構完整，但驗證不涵蓋所有 R4 約束規則（僅檢查必要欄位）

• FHIR Medication: 支援基本結構，成分含量單位硬編碼為 "mg"，未支援複雜單位轉換

• 驗證功能: 基礎驗證（必要欄位、資源類型），不涵蓋高級驗證和術語綁定完整檢查

• 生產環境: 若用於生產醫療系統，建議集成 HL7 FHIR Validator 進行完整驗證

• 應用場景: 適合演示、MCP 集成、研究用途；生產醫療系統需額外驗證層

⚠️ 健康食品與飲食建議注意事項 本服務的健康食品分析和飲食建議功能（含 疾病與保健食品關聯分析 和 飲食營養建議）仍在開發測試階段，具體說明如下：

• 數據來源: 疾病代碼與保健功效的對應關係、飲食建議內容目前為開發者整理，未經過專業醫學/營養師正式審核

• 專業驗證必需: 任何使用此功能產出的建議，在應用於實際醫療或健康指導前，必須經過持證營養師、醫師或相關醫療專業人士的審核和簽名

• 法規遵循: 健康食品依據《健康食品管理法》受台灣衛福部管制，本服務提供的推薦內容不構成醫療診斷、治療或處方

• 開發階段: 疾病-保健功效對應表（見 src/health_food_service.py 第 29-79 行）需驗證是否符合台灣 FDA 核可的功效清單；飲食建議內容（見 src/health_food_service.py 第 414-438 行）需經營養專家確認細節準確性

• 適用場景: 當前適合開發者測試、演示和教育用途；不適合用於生產醫療系統或直接面向患者

• 貢獻方式: 歡迎提交 Issue 或 Pull Request，幫助補充或驗證醫療專業知識，詳見 CONTRIBUTING.md

🛠️ MCP 工具清單

本服務提供 32 個 MCP 工具：

📊 資料來源

台灣官方資料

• 衛福部 ICD-10 中文化資料

• FDA 藥品資料（5 個 API）

• FDA 健康食品資料

國際標準

• FHIR R4 - HL7 International

• LOINC - Regenstrief Institute

• ICD-10 - WHO

• ATC - WHO

📦 版本

v1.1.0 - 完整的台灣醫療健康資料整合 MCP 伺服器

詳見 Git 提交歷史或 src/README.md 了解功能詳情。

🤝 貢獻

歡迎貢獻！詳見 CONTRIBUTING.md 了解詳細步驟和方向。

Made with contrib.rocks.

📝 授權

MIT License - 詳見 LICENSE 檔案

使用的開放資料和標準：

• 台灣政府開放資料 - 政府資料開放授權條款

• LOINC & FHIR & ICD - 免費用於臨床、研究、教育

📞 聯絡資訊

• GitHub Issues: 回報問題

• Email: support@healthymind-tech.com

• 文件: 參閱 src/README.md

🙏 致謝

感謝提供開放資料和標準的組織：

• 台灣衛福部、TFDA（ICD、藥品、健康食品資料）

• Regenstrief Institute（LOINC）

• HL7 International（FHIR）

• WHO（ICD、ATC）

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