跳轉到

Taiwan ICD10 Health MCP

# 🇹🇼 台灣醫療健康資料整合 MCP 伺服器 **整合 ICD-10、FDA 藥品、保健食品、營養資料、LOINC 檢驗、臨床指引，支援 FHIR R4 標準** [![FHIR](https://img.shields.io/badge/FHIR-R4-blue)](http://hl7.org/fhir/R4/) [![Python](https://img.shields.io/badge/Python-3.8+-green)](https://www.python.org/) [![MCP](https://img.shields.io/badge/MCP-1.0-orange)](https://modelcontextprotocol.io) [![License](https://img.shields.io/badge/License-MIT-yellow)](https://github.com/yourusername/Taiwan-ICD10-Health-MCP/blob/main/LICENSE) [快速開始](getting-started.md){ .md-button .md-button--primary } [查看 GitHub](https://github.com/yourusername/Taiwan-ICD10-Health-MCP){ .md-button }

✨ 專案特色

  • 🇹🇼 台灣在地化

    專為台灣醫療環境設計，支援繁體中文，整合台灣官方資料

  • 🔗 標準化整合

    符合國際 FHIR R4、LOINC、ICD-10、ATC 標準

  • 📊 官方資料

    整合台灣 FDA、衛福部官方開放資料平台

  • 🤖 AI 整合

    透過 MCP 協議與 Claude 無縫對接

  • 🔄 持續更新

    資料可自動同步台灣 FDA API 最新資訊

  • 🧪 完整測試

    提供完整的測試腳本與使用範例

🎯 核心功能

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

  • ✅ 診斷碼（ICD-10-CM）與手術碼（ICD-10-PCS）搜尋
  • ✅ 診斷併發症推論
  • ✅ 診斷與手術碼衝突檢查
  • ✅ 轉換為 FHIR Condition 資源

2. 台灣 FDA 藥品資料整合

整合 5 個官方資料集：

  • ✅ 藥品許可證（名稱、適應症、製造商）
  • ✅ 藥品外觀識別（形狀、顏色、刻痕、圖片）
  • ✅ 藥品成分（有效成分、含量）
  • ✅ ATC 藥物分類（WHO 標準）
  • ✅ 藥品仿單/說明書
  • ✅ 轉換為 FHIR Medication/MedicationKnowledge 資源

3. LOINC 檢驗碼整合

  • ✅ LOINC 碼對照（台灣常用 30+ 項，可擴展至 87,000+ 項）
  • ✅ 檢驗參考值查詢（依年齡、性別）
  • ✅ 檢驗結果自動判讀
  • ✅ 批次判讀多項檢驗

4. 臨床診療指引

  • ✅ 台灣醫學會臨床指引查詢
  • ✅ 診斷建議、用藥建議、檢查建議
  • ✅ 治療目標與臨床路徑規劃

5. FHIR R4 標準轉換

  • ✅ FHIR Condition - ICD-10 診斷資源
  • ✅ FHIR Medication - 藥品資源
  • ✅ FHIR MedicationKnowledge - 藥品知識庫
  • ✅ 符合國際醫療資訊交換標準

📊 系統架構

graph TB
    subgraph "使用者層"
        A[Claude AI]
    end

    subgraph "MCP 協議層"
        B[MCP Server<br/>32 個工具]
    end

    subgraph "服務層"
        C1[ICD Service]
        C2[Drug Service]
        C3[FHIR Service]
        C4[Lab Service]
        C5[Guideline Service]
    end

    subgraph "資料層"
        D1[(ICD-10 DB)]
        D2[(Drug DB)]
        D3[(LOINC DB)]
        D4[(Guideline DB)]
    end

    subgraph "外部資料源"
        E1[台灣 FDA API]
        E2[LOINC 官方]
        E3[衛福部 ICD-10]
    end

    A --> B
    B --> C1
    B --> C2
    B --> C3
    B --> C4
    B --> C5

    C1 --> D1
    C2 --> D2
    C4 --> D3
    C5 --> D4

    E1 -.->|同步| D2
    E2 -.->|整合| D3
    E3 -.->|匯入| D1

    style A fill:#e1f5ff
    style B fill:#fff3e0
    style C1 fill:#f3e5f5
    style C2 fill:#f3e5f5
    style C3 fill:#f3e5f5
    style C4 fill:#f3e5f5
    style C5 fill:#f3e5f5

查看詳細架構

🚀 快速開始

# Clone 專案
git clone https://github.com/yourusername/Taiwan-ICD10-Health-MCP.git
cd Taiwan-ICD10-Health-MCP

# 啟動服務
docker-compose up -d

# 查看日誌
docker-compose logs -f

# Clone 專案
git clone https://github.com/yourusername/Taiwan-ICD10-Health-MCP.git
cd Taiwan-ICD10-Health-MCP

# 安裝相依套件
pip install -r requirements.txt

# 準備資料（下載 ICD-10 Excel 檔案到 data/ 目錄）

# 啟動服務
python src/server.py

詳細安裝說明

💡 使用範例

範例 1: 完整診療流程

from icd_service import ICDService
from fhir_condition_service import FHIRConditionService
from clinical_guideline_service import ClinicalGuidelineService

# 1. 搜尋診斷
icd = ICDService('data/icd.xlsx', 'data')
result = icd.search_codes("糖尿病", type="diagnosis")

# 2. 建立 FHIR Condition
fhir = FHIRConditionService(icd)
condition = fhir.create_condition(
    icd_code="E11.9",
    patient_id="patient-001",
    clinical_status="active"
)

# 3. 查詢臨床指引
guideline = ClinicalGuidelineService('data')
pathway = guideline.suggest_clinical_pathway("E11")

範例 2: 藥品查詢與 FHIR 轉換

from drug_service import DrugService
from fhir_medication_service import FHIRMedicationService

# 1. 搜尋藥品
drug = DrugService('data')
result = drug.search_drug("普拿疼")

# 2. 建立 FHIR Medication
fhir_med = FHIRMedicationService(drug)
medication = fhir_med.create_medication_from_search(
    keyword="普拿疼",
    resource_type="Medication"
)

更多範例

🛠️ MCP 工具清單

本服務提供 32 個 MCP 工具，分為 10 個群組：

群組 工具數量 主要功能
ICD-10 工具 4 診斷/手術碼查詢、併發症推論
藥品工具 3 藥品查詢、外觀識別
健康食品工具 2 健康食品查詢、分析
營養工具 5 營養成分查詢、膳食分析
FHIR 工具 7 FHIR 資源轉換、驗證
檢驗工具 5 LOINC 查詢、結果判讀
臨床指引工具 5 指引查詢、路徑規劃
綜合分析工具 1 跨模組整合分析

查看完整工具清單

📚 文件導覽

📊 資料來源

台灣官方資料

  • 🇹🇼 衛福部 ICD-10 中文化資料
  • 🇹🇼 FDA 藥品資料（5 個 API）
  • 🇹🇼 FDA 健康食品資料

國際標準

  • 🌍 FHIR R4 - HL7 International
  • 🌍 LOINC - Regenstrief Institute
  • 🌍 ICD-10 - WHO
  • 🌍 ATC - WHO

查看資料來源詳情

🤝 貢獻

歡迎貢獻！我們需要：

  • 🔹 新增更多 LOINC 中文對照
  • 🔹 補充臨床診療指引資料
  • 🔹 實作更多 FHIR 資源
  • 🔹 改善效能與快取機制

查看貢獻指南

📝 授權

本專案採用 MIT License - 詳見 LICENSE

🙏 致謝

感謝以下組織提供開放資料：

  • 🇹🇼 中華民國衛生福利部
  • 🇹🇼 台灣食品藥物管理署 (TFDA)
  • 🌍 Regenstrief Institute (LOINC)
  • 🌍 HL7 International (FHIR)
  • 🌍 World Health Organization (ICD, ATC)
**⭐ 如果這個專案對您有幫助，請給我們一個 Star！** [GitHub](https://github.com/yourusername/Taiwan-ICD10-Health-MCP){ .md-button .md-button--primary }