Skip to main content
Glama
trionnemesis

Healthcare OpenData MCP

by trionnemesis
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

Healthcare OpenData MCP (hcmcp)

醫療健保開放資料 MCP — 健保署開放資料 × 衛福部標案,對齊 Twinkle Hub query_rows,完全自主資料來源

Python 3.11+ License: MIT FastMCP

因 hub.twinkleai.tw 政策異動停用而自建的替代方案:以 FastMCP 封裝台灣醫療健保開放資料與衛福部標案,提供 Twinkle Hub 相容的 SQL 式查詢(query_rows),不依賴任何第三方聚合服務。

資料來源(全部一級官方來源)

來源

資料集

取得形式

健保署資料開放平台 info.nhi.gov.tw

特約醫事機構(地區/區域醫院)

CSV API,每日更新、免 key

政府電子採購網 web.pcc.gov.tw

pcc-tender-mohw(衛福部標案,twinkle pcc-tender 欄位相容)

半月公開 XML

Related MCP server: MCP TDCC

快速開始

# 安裝
git clone <repo-url> && cd healthcare-opendata-mcp
python3.11 -m venv .venv && .venv/bin/pip install -e .

# 同步資料(預設 ~/.hcmcp/hcmcp.db;決標 12 月、招標 3 月)
.venv/bin/hcmcp-sync

# 加入 Claude Code
claude mcp add hcmcp -- /path/to/.venv/bin/hcmcp

SSE 模式(團隊共用 / 容器部署):

HCMCP_TRANSPORT=sse HCMCP_PORT=8000 hcmcp

MCP 工具

工具

說明

list_datasets

列出可查詢資料集

get_dataset(dataset_id, sample_rows)

metadata + schema + 抽樣資料列

query_rows(dataset_id, where, columns, group_by, order_by, limit)

SQL 式查詢與聚合(對齊 twinkle)

search_records(keyword, dataset_id)

跨資料集關鍵字搜尋

get_record(dataset_id, natural_key)

取單筆完整資料

list_sources

列出資料來源與最後抓取時間

query_rows 範例(twinkle 查詢模式直接沿用):

query_rows(
    dataset_id="pcc-tender-mohw",
    columns=["agency", "COUNT(*) AS n", "SUM(CAST(award_price AS INTEGER)) AS total"],
    where="announcement_type='決標公告' AND date >= '2025-01-01'",
    group_by=["agency"],
    order_by="total DESC",
)

SQL 安全(OWASP A03)

query_rows 接受原始 SQL 片段,以雙層防禦保護:

  1. 語法層(query_guard):僅單一 SELECT;拒絕 ; 多語句、註解、PRAGMA/ATTACH/DML/DDL;limit 硬上限 200

  2. 執行層(query_executor):mode=ro 唯讀連線 + sqlite authorizer 白名單(僅允許讀單一物化表,跨表子查詢一律拒絕)+ VM 步數上限

架構

src/health_opendata_mcp/
├── contracts.py      跨層 DTO、Enum、Protocol(DI 邊界)
├── domain/           query_guard(SQL 安全驗證純函式)
├── adapters/         SourceAdapter 實作(可插拔多來源)
│   ├── nhi.py            健保署 CSV API
│   ├── pcc_tender.py     PCC 半月 XML(vendored 解析純函式)
│   └── _http.py          共用 async HTTP getter(DI 預設值)
├── ingestion/        pipeline(discover→fetch→normalize→upsert,容錯)
├── repository/       SQLite 基底表 + ds_{dataset_id} 物化表 + 唯讀 executor
└── mcp_server/       FastMCP 6 工具 + QueryService

spec/
├── erm.dbml          領域模型(DataSource/Dataset/Record/IngestionRun + 不變量)
└── features/         Gherkin BDD 行為規格(5 features)

資料流:hcmcp-sync(ETL,可排程)→ SQLite(records 正準 + 物化查詢表同交易)→ hcmcp(唯讀 MCP server)→ Claude/Agent。抓取與查詢分離,headless browser 無必要場景(介面保留、預設停用)。

新增資料集:健保署資料集只需在 cli.py 的 NHI_DATASETS 登錄 rId(從 data.gov.tw 對應資料集頁取得);新資料來源則實作 SourceAdapter Protocol(discover/fetch/normalize 三方法)。

開發

.venv/bin/pip install -e ".[dev]"
.venv/bin/python -m pytest        # 52 tests

完整 SDD 規格(評估矩陣 / BDD / DDD / 架構 / Twinkle 功能對齊)維護於 Notion「醫療健保開放資料 MCP」條目。

相關專案

g0VMCP — 衛福部標案的生命週期/明細加值 MCP(招標→更正→決標狀態機、開標時間/預算 enrich)。兩專案刻意零耦合:hcmcp 提供 twinkle 相容的扁平列查詢,g0VMCP 提供深度標案情報;PCC XML 解析純函式 vendored 自 g0VMCP。

License

MIT — 資料依政府資料開放授權條款使用。

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/trionnemesis/healthcare-opendata-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server