最新
療心智能正式加入 NVIDIA Inception 新創計畫 | 療心智能入選 Anthropic Claude Startups 計畫 | 療心智能進入 2026 資訊應用服務創新創業新秀選拔決選 | DietMate 臨床營養 AI 平台開放診所試用 | Taiwan Health MCP v0.1.0 更新上線,支援 FHIR R4 資源與台灣 FDA 藥品查詢 → | 
聯絡我們
✓ 連結已複製

Taiwan Health MCP 線上版使用指南:在 Claude 與 Cursor 直接查詢台灣藥品與 FHIR 資料

Taiwan Health MCP 提供免自架伺服器的連線端點,讓開發者在 Claude Code、Claude Desktop 或 Cursor 中直接查詢台灣食藥署藥品仿單、辨識外觀特徵,並產出標準 FHIR R4 Medication 資源。

BY 療心智能團隊 2026.08.09 · 5 分鐘閱讀
Key Takeaways
  • 免除本機基礎設施負擔:開發者無須自行建置 PostgreSQL 與向量資料庫,直接透過 Streamable HTTP 端點即可將台灣醫療資訊整合至大型語言模型。
  • 支援主流 MCP 客戶端生態:全面相容 Claude Code、Claude Desktop、Cursor 等開發環境,一行指令即可完成工具宣告與載入。
  • 打通台灣藥品與 FHIR 標準:內建食藥署藥品許可證資料庫與外觀特徵索引,支援將查詢結果自動映射為國際標準 FHIR R4 Medication 結構。
  • 雙軌部署架構:提供免設定的公有端點進行概念驗證(PoC),同時完整開源 Docker 部署腳本,滿足醫療院所對資安防護與內網隔離的嚴格規範。

為什麼醫療 AI 開發需要專屬的 Context Protocol?

在過去,當開發者嘗試讓 Claude 或其他 AI Agent 協助處理台灣醫療場景的任務時,經常面臨幾個關鍵痛點:

  1. 藥品代碼與本土商品名脫節:通用語言模型對台灣本土藥品商品名(如「普拿疼肌立」、「合利他命」)或健保代碼缺乏最新索引,容易產生幻覺。
  2. 資料格式不符合國際醫療標準:模型輸出的藥物建議多為非結構化文字,無法直接寫入電子病歷(EMR)或對接臨床 FHIR 伺服器。
  3. 本機部署維護成本高昂:若要讓 Agent 查詢官方藥品資料,開發者得自行抓取食藥署 Open Data、建立全文檢索與 pgvector 向量庫,並持續追蹤仿單更新。

為了解決這些問題,療心智能團隊開源了 Taiwan Health MCP,並正式開放免架設的線上公開端點,讓醫療科技開發者能專注於打造 Agentic Workflow 與臨床應用,無須分心於繁雜的資料管線維護。


線上端點開放工具清單(v0.1.0)

Taiwan Health MCP 線上端點目前開放 10 項核心工具,劃分為四大模組:

模組分類工具名稱 (Tool)臨床與開發應用場景
藥品檢索search_drug依據中文品名、英文品名、主成分或許可證字號檢索台灣藥品
藥品檢索identify_unknown_pill依據藥丸外觀特徵(形狀、顏色、刻痕、標記)辨識不明處方藥
藥品檢索get_drug_details提取單一藥品之完整適應症、用法用量、警語與仿單內容
藥品檢索get_drug_asset_links取得藥品外觀照片與衛福部核定仿單 PDF 原檔連結
FHIR 標準轉換query_fhir_medication將台灣藥品資料自動轉換為標準 FHIR R4 Medication 結構
FHIR 標準轉換validate_fhir_medication驗證輸入之 Medication JSON 是否符合 FHIR R4 規格定義
外部伺服器管理list_fhir_servers檢視系統管理員所配置之機構外部 FHIR 伺服器清單
外部伺服器管理get_fhir_server_status檢測目標 FHIR 伺服器之連線延遲與權限狀態
外部伺服器管理crud_fhir_server對特定 FHIR 伺服器執行安全的資源讀寫調度
系統監控health_check確認 MCP 核心服務與後端檢索管線之運作狀態

快速設定指引:3 分鐘完成整合

方法一:在 Claude Code (CLI) 中快速載入

開啟終端機,執行以下指令建立 HTTP 傳輸連線:

claude mcp add --transport http tw-health-mcp https://tw-health-mcp.healthymind-tech.com/mcp

驗證連線狀態:

claude mcp list

當看到 ✔ Connected tw-health-mcp 標記時,即表示工具載入完成。隨後即可在對話中直接發出查詢請求:

幫我查詢「普拿疼肌立水性酸痛藥布」的許可證字號、主成分與適應症,並將結果輸出為 FHIR Medication 格式。

方法二:在 Claude Desktop 中配置

若使用桌面版 Claude,請在設定檔 claude_desktop_config.json 中加入伺服器宣告:

  • macOS 設定路徑:~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows 設定路徑:%APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "tw-health-mcp": {
      "type": "http",
      "url": "https://tw-health-mcp.healthymind-tech.com/mcp"
    }
  }
}

存檔並重啟 Claude Desktop 後,對話視窗右下角將出現工具啟用圖示。


方法三:在 Cursor / Windsurf 等 IDE 中使用

在 IDE 的 MCP 設定面板中新增 Custom Server:

  • Server Type:HTTP / SSE
  • Server URL:https://tw-health-mcp.healthymind-tech.com/mcp

實際呼叫範例與資料回傳結構

範例:不明藥物特徵辨識與成分檢索

當患者或長輩手中有散裝藥丸但遺失藥袋時,可透過外觀特徵進行精準比對:

使用者提問:
我有一顆圓形、白色、中間有一道刻痕、上面印有「Y-P」字樣的藥丸,請幫我查詢可能是什麼藥?

AI Agent 呼叫 identify_unknown_pill 工具後,後端將返回匹配之候選藥品清單與許可證資訊,協助醫事人員或個管師進行快速核對。


醫療機構與企業自建部署方案

針對需要處理機敏病歷資料、遵循 HIPAA 或台灣個人資料保護法之醫療院所,建議採用地端私有化部署架構。

[院內 HIS / 護理系統]
        ↓
[Claude / 院內私有 LLM] 
        ↓ (內網呼叫)
[Taiwan Health MCP Server (Docker)] 
        ↓
[PostgreSQL + pgvector (台灣食藥署本地資料庫)]

部署步驟

# 取得開源專案程式碼
git clone https://github.com/healthymind-tech/Taiwan-Health-MCP
cd Taiwan-Health-MCP

# 設定環境變數
cp .env.example .env

# 啟動容器服務
docker compose up -d

啟動後,地端 MCP 服務將監聽 http://localhost:8080/mcp。

地端環境需求

  • 資料庫:PostgreSQL 16(需載入 pgvector 延伸模組以支援語意檢索)
  • 快取層:Redis 7+
  • 資產儲存:MinIO 或 S3 相容物件儲存(存放仿單與藥物外觀圖檔)
  • 執行環境:Node.js 20+ 與 Docker Compose 2.0+

開源共創與後續發展規劃

Taiwan Health MCP 採用寬鬆的 MIT 開源授權,專案原始碼完整公開於 GitHub:

👉 GitHub 專案庫:https://github.com/healthymind-tech/Taiwan-Health-MCP

後續版本將依據臨床需求陸續擴充以下功能模組:

  1. 台灣 ICD-10-CM 診斷代碼智慧對照引擎
  2. LOINC 檢驗檢查項目與參考值查詢
  3. 台灣全民健保給付規定與適應症檢核規則庫

若您的團隊在醫療院所整合、FHIR 資料交換或 DietMate 臨床營養 AI 平台 導入上有評估需求,歡迎隨時與我們的臨床工程團隊聯繫。

👉 預約醫療機構技術評估與方案諮詢


相關文章推薦:

療
ABOUT THE AUTHOR
療心智能團隊

醫療 AI 實作團隊

我們關心的不是 AI 能不能看懂病歷,而是患者離開醫院後那 99% 的時間有沒有人接住。這裡的文章來自我們開發 DietMate、CareMate 與 Taiwan Health MCP 的第一手經驗,技術、產業與倫理都談。

FAQ

常見問題

討論區 (0 則留言)

加載評論中...