health-skillz MCP — 使用場景, 安裝 & 即時演示

為什麼要用

核心特性

OAuth-based authentication against any FHIR-compliant provider
Read-only by default — no prescribing or charting
Supports all major US hospital portals (Epic MyChart, Cerner, Athena)
Parses clinical codes (LOINC, RxNorm, SNOMED) back to human language
Open-source — you see exactly what's queried

即時演示

實際使用效果

health-skillz-skill.replay ▶ 就緒

0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "health-skillz-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "health-skillz-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/jmandel/health-skillz",
          "~/.claude/skills/health-skillz"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add health-skillz-skill -- git clone https://github.com/jmandel/health-skillz ~/.claude/skills/health-skillz

一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。

使用場景

實戰用法： health-skillz

Ask plain questions about your lab result trends

👤 Patients tracking chronic conditions, cholesterol, A1c ⏱ ~15 min beginner

何時使用： You've had repeated labs over months/years and want to see the trajectory, not just each result in isolation.

前置條件

A patient portal with FHIR access — Most major US health systems support SMART on FHIR — check your portal for API/app access
Skill installed — git clone https://github.com/jmandel/health-skillz ~/.claude/skills/health-skillz

步驟

Authenticate

Use health-skillz to connect to my Epic MyChart account.✓ 已複製

→ Browser opens SMART launch; token stored locally
Pull labs

Show my LDL, HDL, and A1c over the past 3 years as a trend.✓ 已複製

→ Time-series table or summary with unit conversions
Contextualize

Relate these to the guideline ranges. Don't give me medical advice — just surface what's in range vs not.✓ 已複製

→ Explicit framing as reference ranges, not diagnosis

結果： A readable longitudinal view of your key labs — useful before your next appointment.

注意事項

Treating Claude's output as medical advice — Always bring questions to your actual clinician. This skill is for understanding your own records, not a second opinion.

Reconcile the medication list before an appointment

👤 Patients on multiple meds from multiple providers ⏱ ~10 min beginner

何時使用： You're about to see a new specialist and want a clean, current med list.

步驟

Fetch active meds

Use health-skillz. Pull my current medication list with dose, frequency, and prescribing provider.✓ 已複製

→ Structured list with RxNorm codes resolved to names
Spot duplicates and gaps

Any duplicate therapy, same-class redundancies, or meds that look expired?✓ 已複製

→ Flags you can raise with your doctor

結果： A med list to hand your new provider on day one.

注意事項

Portals sometimes miss OTC meds — Supplement manually; the portal only shows what was prescribed via it

Export a relevant subset of records for a new specialist

👤 Patients changing providers or seeing a specialist ⏱ ~20 min intermediate

何時使用： You're consolidating records for a second opinion.

步驟

Filter

Use health-skillz. Pull all cardiology-related encounters, labs, and imaging from the last 2 years.✓ 已複製

→ Filtered export grouped by encounter
Format

Format as a one-page summary a specialist can skim in 30 seconds.✓ 已複製

→ Compact doc with key dates, diagnoses, pertinent findings

結果： A portable summary you own — not a 200-page PDF dump.

注意事項

Losing nuance by summarizing — Always bring the full export as backup; summary is for quick triage

搭配使用： filesystem

組合

與其他 MCP 搭配，撬動十倍槓桿

health-skillz-skill + filesystem

Save exports to an organized local folder structure

Save the cardiology export to ~/health/specialists/cardio-2026.md✓ 已複製

工具

此 MCP 暴露的能力

工具	輸入參數	何時呼叫	成本
smart_launch	provider URL	First-time connection to a provider	OAuth redirect
get_observations	patient id, category, date range	Pulling labs or vitals	FHIR API call
get_medications	patient id, status	Med reconciliation	FHIR API call
get_encounters	patient id, date range	Visit history review	FHIR API call

成本與限制

運行它的成本

API 配額: Depends on the provider's FHIR API limits
每次呼叫 Token 數: Moderate — lab results are compact
費用: Free (portal access is included with care)
提示: Pull in one category at a time; full 'everything' exports are token-expensive.

安全

權限、密鑰、影響範圍

最小權限： patient/*.read

憑證儲存： OAuth token in local credential store; never committed

資料出站： Your FHIR server and Anthropic API only

切勿授予： user/*.write system/*.*

This is NOT medical advice. The skill surfaces your own records; decisions remain with you and your clinicians.
Health data is sensitive. Understand that by querying via Claude, excerpts of your records are sent to Anthropic's API per their data policies.
Revoke the app's access from your patient portal when you're done.

故障排查

常見錯誤與修復

SMART launch fails with redirect error

Most portals require pre-registering the app's redirect URI. Check the skill's docs for your provider.

Empty results despite having data in portal

Your provider may restrict FHIR scopes; try narrower queries or contact support.

Lab codes show as raw LOINC IDs

Ensure the skill's code map is current; may need to update the clone.

驗證： cd ~/.claude/skills/health-skillz && git pull

替代方案

health-skillz 對比其他方案

替代方案	何時用它替代	權衡
Manual portal export	One-time export of all records	PDF dump, not queryable
Apple Health app	iOS-centric consumer aggregation	Closed data; no LLM querying

health-skillz

為什麼要用

核心特性

即時演示

實際使用效果

安裝

選擇你的客戶端

使用場景

實戰用法： health-skillz

Ask plain questions about your lab result trends

前置條件

步驟

注意事項

Reconcile the medication list before an appointment

步驟

注意事項

Export a relevant subset of records for a new specialist

步驟

注意事項

組合

與其他 MCP 搭配，撬動十倍槓桿

工具

此 MCP 暴露的能力

成本與限制

運行它的成本

安全

權限、密鑰、影響範圍

故障排查

常見錯誤與修復

替代方案

health-skillz 對比其他方案

更多

資源