文章目錄
一件事先講清楚：Taiwan Health MCP 的線上免費版終於可以串了 — 不用自己架伺服器，一行指令就能在 Claude 裡查詢台灣藥品、產出 FHIR Medication 資源。目前是 v0.1.0 測試版，免費無償提供，連線偶爾可能不穩。這篇就是 5 分鐘上手的教學。
這次上線了什麼？
過去想用 Taiwan Health MCP，你得先自己 git clone、架好 PostgreSQL、跑 Docker Compose —— 對只想先「試試看」的開發者來說，門檻不低。
從現在開始不用了。我們上線了線上免費版：
- 不需要自己架伺服器，直接連
https://tw-health-mcp.healthymind-tech.com/mcp就能用 - 不需要 API key，裝好就能查
- 目前是 v0.1.0 測試版，免費無償提供，因此連線可能不穩定 — 如果某個時刻回不去，稍後再試即可
線上版目前開放了 10 個工具，分成「藥品查詢」、「FHIR Medication」、「FHIR 伺服器管理」與「系統」四大類：
| 模組 | 工具 | 用途 |
|---|---|---|
| 🧪 藥品查詢 | search_drug | 用藥名、成分、許可證字號查台灣食藥署藥品 |
| 🧪 藥品查詢 | identify_unknown_pill | 依外觀（形狀／顏色）辨識不明藥丸 |
| 🧪 藥品查詢 | get_drug_details | 查單一藥品的詳細仿單、用量、注意事項 |
| 🧪 藥品查詢 | get_drug_asset_links | 取得藥品圖檔等資產連結 |
| 🩺 FHIR Medication | query_fhir_medication | 把藥品轉成 FHIR R4 Medication 資源 |
| 🩺 FHIR Medication | validate_fhir_medication | 驗證 FHIR Medication 資源結構與欄位 |
| 🔌 FHIR 伺服器管理 | list_fhir_servers | 列出系統管理員設定的外部 FHIR 伺服器 |
| 🔌 FHIR 伺服器管理 | get_fhir_server_status | 查看單一外部 FHIR 伺服器的狀態與設定 |
| 🔌 FHIR 伺服器管理 | crud_fhir_server | 對已設定的 FHIR 伺服器執行受控的 REST 操作 |
| ⚙️ 系統 | health_check | 檢查 MCP Server 及各模組服務的健康狀態 |
想找的病碼（ICD-10）、檢驗（LOINC）、SNOMED 呢？ 都在後續版本的路線上。線上版目前先開放最常用的藥品場景，其他模組逐步加入。
3 分鐘在 Claude 裝好
安裝只需要 一個指令（這是 HTTP transport 的標準寫法）：
步驟 1：宣告伺服器
claude mcp add --transport http tw-health-mcp https://tw-health-mcp.healthymind-tech.com/mcp
步驟 2：確認有接上
claude mcp list
看到 ✔ Connected tw-health-mcp 就表示成功了。
步驟 3：在對話中直接問
接著只要開啟 claude，直接講人話就行：
幫我用 taiwan-health-mcp 查一下「普拿疼肌立水性酸痛藥布」的許可證資訊
第一次呼叫工具時，Claude 會跳出一個權限確認視窗，選 「允許」（或勾選 Always allow）就好了。之後再問，就會直接幫你查。
💡 順帶一提：只要你的機器裝好 Claude Code，就不需要 API key、不需要自己跑任何伺服器。裝好、問問題，剩下的就交給 Claude 與 Taiwan Health MCP（目前為免費無償提供）。
實測給你看
以下是我實際連上線上版跑過的真實結果（複製自線上端點，非示意）。
範例 1：查藥品
範例 2：產生 FHIR Medication 資源
本功能還在實驗當中，產生的資訊或許有幻覺，再請多多查證！
不只 Claude Code：任何 MCP Client 都能接
線上版用的是標準 MCP（streamable-HTTP）protocol，所以只要支援 MCP 的軟體（Claude Desktop、Cursor、Cline、Windsurf…）都能用同一個 endpoint：
在 Claude Desktop 裡，把下面設定放到 claude_desktop_config.json：
{
"mcpServers": {
"tw-health-mcp": {
"type": "http",
"url": "https://tw-health-mcp.healthymind-tech.com/mcp"
}
}
}
醫院 / 機構端：自行架設
如果您的場域對穩定、資安、資料掌控度有更高要求（例如醫院、診所、研究機構），我們也完全開放自行架設 — 專案是 MIT 開源。
git clone https://github.com/healthymind-tech/Taiwan-Health-MCP
cd Taiwan-Health-MCP
cp .env.example .env
docker compose up -d
啟動後，MCP 端點在：
http://<你的主機>:8080/mcp
系統需求：
- PostgreSQL 16（含 pgvector 擴充）
- Redis（用來快取回應）
- MinIO（藥品圖檔等物件儲存）
- Node.js 20+（MCP Server 本體）
- （若啟用語意搜尋）Ollama 嵌入模型
兩個務必注意的資安提醒（README 有寫）：
- MCP 與 OpenAPI 介面預設未強制驗證，若對外公開，建議透過反向代理加上授權 token / 限流。
- 自我架設時，資料庫與連線都在你自己的環境，最適合醫療院所的資安政策。
醫療機構想要評估整合？可以預約我們的技術團隊，幫你評估 FHIR 對接、內網部署與 DietMate 整合導入。
版本與期望管理：v0.1.0
說白話一點：
- 現在的線上服務是 v0.1.0 測試版，由我們自費提供、免費無償。
- 既然免費，就不保證 SLA——可能因流量或機器重啟而有連線不穩的情形，偶爾遇到請再次嘗試。
- 這也代表：歡迎反饋。可以開 Issue 回報工具回問題、資料補漏、想開放哪個模組，都會成為新版本的優先順序。
- GitHub：https://github.com/healthymind-tech/Taiwan-Health-MCP（MIT）
如果你需要更重要的是穩定的連線、內網部署或技術整合，請考慮自架，或直接聯繫我們討論導入方案。
你想了解更多 Taiwan Health MCP？
若對醫院導入、FHIR 對接與 DietMate 找一條完整的臨床照護方案有興趣，歡迎 預約專人簡報。
討論區 (0 則留言)