loading…
Browse all
Featherless
FreeEnables interaction with FHIR R4 healthcare data through SHARP-on-MCP tools, including search, read, and clinical context aggregation, with built-in Chart.js da
About
Enables interaction with FHIR R4 healthcare data through SHARP-on-MCP tools, including search, read, and clinical context aggregation, with built-in Chart.js dashboards for visualizing lab trends, vitals, and patient data.
README
TypeScript SHARP-on-MCP-compliant FHIR R4 MCP server with MCP-UI clinical dashboards. Runs on Cloudflare Workers.
Sibling project to sharp-fhir-mcp (Python, FastMCP 2.x). Same SHARP semantics, same tool set, same MCP-UI Chart.js visualizations — re-implemented in TypeScript for the edge.
What's included
Core
- SHARP HTTP transport via Cloudflare
agentsSDK (McpAgent, Durable Object–backed sessions) - Header-based context (
X-FHIR-Server-URL,X-FHIR-Access-Token,X-Patient-ID) with SMART JWT claim fallback - Strict and permissive context modes
experimental.fhir_context_requiredcapability injected intoinitialize
Tools (parity with sharp-fhir-mcp)
tools/fhir.ts— generic FHIR R4 search/readtools/clinical.ts— Patient / Encounter / Appointment / Allergy / Medication / Problemtools/lab-imaging.ts— Observation / DiagnosticReport / DocumentReferencetools/clinical-context.ts— aggregated visit context with derived alertstools/memory.ts— clinical memory backed by Cloudflare Vectorize + Workers AI + D1tools/visualization.ts— MCP-UI Chart.js dashboards (visualize_lab_trend,visualize_vitals,visualize_patient_dashboard)
Getting started
pnpm install
# create the Vectorize index (once)
pnpm wrangler vectorize create featherless-memory --dimensions=768 --metric=cosine
# create the D1 database (once), put the id into wrangler.jsonc
pnpm wrangler d1 create featherless-memory-meta
pnpm db:migrate:remote
# develop
pnpm dev
SHARP context
Forward these headers on every tools/call:
| Header | Purpose |
|---|---|
X-FHIR-Server-URL |
FHIR R4 base URL |
X-FHIR-Access-Token |
OAuth2/SMART access token (Bearer optional) |
X-Patient-ID |
Optional; falls back to JWT patient claim |
License
MIT.
How to install
Add this to claude_desktop_config.json and restart Claude Desktop.
{
"mcpServers": {
"featherless": {
"command": "npx",
"args": []
}
}
}
