Skip to main content
Glama

PyPI Version Stars Downloads

License Python Versions Build Status AI-Assisted Development DOI

Substack Discord

Agenten lesen klinische Daten problemlos – das korrekte Zurückschreiben ist der schwierige Teil, und generische Agent-Frameworks prüfen das nicht. HealthChain gibt jedem Modell oder Agenten typisierte, validierte FHIR-Werkzeuge, denen sie vertrauen können: den richtigen Code vom richtigen System, für den richtigen Patienten, mit einem gültigen Status. Dazu Echtzeit-EHR-Anbindung und Produktionsbereitstellung – damit das, was du baust, auch außerhalb der Demo Bestand hat.

Installation

pip install healthchain

Related MCP server: FhirMCP

Quick Start

# Scaffold a FHIR Gateway project
healthchain new my-app -t fhir-gateway
cd my-app

# Run locally
healthchain serve

Bearbeite app.py, um dein Modell hinzuzufügen, und healthchain.yaml, um die Bereitstellungseinstellungen zu konfigurieren.

Siehe die CLI-Referenz für alle Befehle.

Kernfunktionen

Der schnellste Weg für KI-Entwickler und Forscher, KI im Gesundheitswesen bereitzustellen – alles, was du brauchst, sofort einsatzbereit und so gebaut, dass es mit dir skaliert.

Warum HealthChain?

Jedes ernsthafte KI-Projekt im Gesundheitswesen baut dieselbe Integrationsinfrastruktur von Grund auf neu auf. Ob du eine logistische Regression, ein 70B-Parameter-Modell oder einen agentischen Workflow bereitstellst – die Mauer zwischen einem trainierten Modell und einem Live-Kliniksystem ist dieselbe: echte FHIR-APIs, validierte Schreibvorgänge, Multi-Standort-Bereitstellungen, prüfbare Governance. Es gibt keine fertige Lösung, und Ingenieure, die sowohl KI als auch Gesundheitsprotokolle verstehen, sind rar und schwer zu halten.

HealthChain übernimmt diese Komplexität, damit du dich auf das konzentrieren kannst, was wirklich zählt: das Modell und den Patienten.

  • Für Echtzeit optimiert – Verbinde dich mit Live-FHIR-APIs und Integrationspunkten statt mit veralteten Datenexporten

  • Validierung eingebaut – Typsichere FHIR-Ressourcen und Validierungsberichte, die defekte Daten abfangen, bevor sie ausgeliefert werden – einschließlich spezifikationsungültiger klinischer Codes, die Typprüfungen allein durchlassen

  • Keine erfundenen Fakten – Helfer fügen keine klinischen Behauptungen hinzu, die du nicht übergeben hast: keine automatisch generierten Zeitstempel, keine geratenen Status – was in die Akte gelangt, ist genau das, was dein Modell erzeugt hat

  • Beliebiges Modell oder Agenten einbinden – LLMs, Agenten oder klassisches ML – und validiertes FHIR ausgeben

  • Funktioniert mit deinem bestehenden Stack – Integration mit FastAPI, MCP und LangChain

  • Produktionsreife Grundlagen – Dockerisierte Bereitstellung, konfigurierbare Sicherheit und eine Architektur, die für NHS- und HIPAA-Umgebungen gebaut ist

🏆 Anerkennung & Community

Vorgestellt und präsentiert:

🤝 Partnerschaften & Produktionseinsatz

Erkundest du HealthChain für dein Produkt oder deine Organisation? Nimm Kontakt auf, um Integrationen, Pilotprojekte oder Kooperationen zu besprechen, oder tritt unserem Discord bei, um dich mit der Community zu vernetzen.

Anwendungsbeispiele

Erstellen eines Gateways [Dokumentation]

from healthchain.gateway import HealthChainAPI, FHIRGateway
from healthchain.fhir.r4b import Patient

# Create healthcare application
app = HealthChainAPI(title="Multi-EHR Patient Data")

# Connect to multiple FHIR sources
fhir = FHIRGateway()
fhir.add_source("epic", "fhir://fhir.epic.com/r4?client_id=epic_client_id")
fhir.add_source("cerner", "fhir://fhir.cerner.com/r4?client_id=cerner_client_id")

@fhir.aggregate(Patient)
def enrich_patient_data(id: str, source: str) -> Patient:
    """Get patient data from any connected EHR and add AI enhancements"""
    bundle = fhir.search(
        Patient,
        {"_id": id},
        source,
        add_provenance=True,
        provenance_tag="ai-enhanced",
    )
    return bundle

app.register_gateway(fhir)

# Available at: GET /fhir/transform/Patient/123?source=epic
# Available at: GET /fhir/transform/Patient/123?source=cerner

if __name__ == "__main__":
    app.run(port=8888)

Agenten FHIR-Werkzeuge geben [Dokumentation]

from healthchain.tools import FHIRToolkit

# One toolkit: build, validate, read, and code FHIR — as typed agent tools
kit = FHIRToolkit(bundle="patient_bundle.json")

kit.as_mcp().run()          # serve to Claude or any MCP client
tools = kit.as_langchain()  # or drop into a LangChain agent

Oder direkt aus dem Terminal, ohne Code:

healthchain mcp --bundle patient_bundle.json

Erstellen mit einem KI-Assistenten

Installiere das HealthChain-Plugin, um Claude Code oder Codex die aktuelle API, CLI und Rezepte bereitzustellen:

# Claude Code
/plugin marketplace add healthchainai/HealthChain
/plugin install healthchain@healthchain

# Codex
codex plugin marketplace add healthchainai/HealthChain
codex plugin add healthchain@healthchain

Oder richte einen beliebigen Assistenten auf llms.txt, um eine Karte der aktuellen API-Dokumentation zu erhalten.

🛣️ Worauf wir hinarbeiten

  • 🔒 Sicherheitsgrundlagen – API-Key-Authentifizierung, Audit-Logging und TLS, konfiguriert über healthchain.yaml und durchgesetzt von der Gateway-Middleware

  • 📋 Governance als Konfiguration – klinische Sicherheit, Datenzugriffsvereinbarungen und Compliance-Standards für NHS/HIPAA-Bereitstellungen als erstklassiges Bereitstellungsartefakt in healthchain.yaml

  • 🔌 Tiefere EHR-Anbindung – mehr FHIR-Quellen, Live-Datenmuster und reale Integrationsbeispiele aus Pilotbereitstellungen

  • 📊 Beobachtbarkeit – Bereitstellungstelemetrie und Audit-Trails für Gesundheitssysteme

  • 🤖 Ein Toolkit für klinische KI-Agenten – typisierte FHIR-Werkzeuge mit integrierter Validierung und Terminologie, bereitgestellt über MCP und LangChain

🤝 Mitwirken

HealthChain wird von und für die nächste Generation von Gesundheitsentwicklern gebaut – Forscher, die Modelle von retrospektiven Daten in Live-Systeme bringen, KI-Entwickler, die nicht Monate damit verbringen wollen, FHIR zu lernen, bevor sie etwas ausliefern können. Die besten Beiträge kommen von Menschen, die auf ein echtes Problem gestoßen sind und etwas Konkretes dazu zu sagen haben.

Erste Schritte:

🤗 Danksagungen

Dieses Projekt baut auf fhir.resources und den CDS Hooks-Standards auf, die von HL7 und dem Boston Children's Hospital entwickelt wurden.

Siehe auch groundeval – das Open-Source-Evaluierungs-Framework für KI-Agenten im Gesundheitswesen.


© 2024–2026 dotimplement ai. HealthChain ist ein Open-Source-Projekt, das von dotimplement ai gepflegt wird.

Available Tools

8 tools
build_resourceA

Build a FHIR resource from flat fields and validate it. Call this instead of writing FHIR JSON by hand — it does the nesting (CodeableConcepts, Dosage) and returns {ok, resource} or {ok: false, issues} to correct. Supported resource_type values: Condition, MedicationStatement, Observation, AllergyIntolerance, Patient. Use a code returned by lookup_code, never an invented one.

Inputs: resource_type (required), code, unit, onset, +12 more.

get_coded_entriesA

Read the coded identity of every resource of a type in the loaded bundle as flat records (code/display/system/status/authored_on/value/unit). Call this first for questions about conditions, medications, allergies, or observations — it resolves medicationReference to the actual Medication for you. Optionally filter by status (e.g. 'active').

Inputs: resource_type (required), status.

get_resourcesA

Get all resources of a type from the loaded bundle as full FHIR JSON. Call this when you need fields the flattened get_coded_entries view doesn't carry.

Inputs: resource_type (required).

list_codesA

List every code in the local terminology catalog, optionally filtered to one code system URI. Call this to browse what codes are available (e.g. to build a mention list); use lookup_code to search by name.

Inputs: system.

load_bundleA

Load a FHIR Bundle from a file path or JSON string and make it the working bundle for the read tools. Call this first when given bundle data. Invalid bundles return issues[] locating each problem (e.g. Bundle.entry[2].resource.subject).

Inputs: source (required).

lookup_codeA

Search the terminology catalog for codes matching free text (e.g. 'metoprolol 25', 'type 2 diabetes'). Call this whenever you need a code — use a returned candidate, never invent or recall one. Results are ranked tightest-match-first; optionally restrict to one code system URI.

Inputs: query (required), system.

resolve_referenceA

Resolve a FHIR reference (e.g. 'Patient/123', 'urn:uuid:...') to its target resource within the loaded bundle. For a contained reference ('#med1'), also pass parent_resource_id — the id of the resource the reference appears in.

Inputs: reference (required), parent_resource_id.

validate_resourceA

Validate a FHIR resource (JSON object) against the spec, including required value-set bindings. Call this after constructing or editing FHIR JSON yourself; read issues[] (severity/diagnostics/expression) and correct the resource. Never raises.

Inputs: resource (required), resource_type.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: building, validating, loading, retrieving, resolving references, and terminology lookup. No two tools overlap in functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using lowercase and underscores, e.g., build_resource, load_bundle, get_resources, lookup_code. This makes the API predictable.

    Tool Count5/5

    With 8 tools, the set is well-scoped for a FHIR utility server, covering essential operations without being bloated or too sparse.

    Completeness4/5

    The set covers building, validating, loading, and reading FHIR resources, as well as reference resolution and terminology lookup. Minor gaps like missing update/delete tools or limited build resource types prevent a perfect score.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables LLM-based agents to interact with FHIR healthcare data through natural language prompts, providing full CRUD operations on FHIR resources, document processing, and semantic search capabilities.
      13
      102
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables LLMs to securely interact with FHIR healthcare servers and HL7 terminology services. Provides comprehensive healthcare data operations with built-in PHI protection, audit logging, and SMART on FHIR authentication.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides seamless integration with FHIR APIs, enabling AI/LLM tools to search, retrieve, and analyze clinical healthcare data with support for SMART-on-FHIR authentication and multiple transport protocols.
      7
      1,087 PyPI
      137
      Apache 2.0
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables LLM-based agents and MCP-compatible clients to query and manipulate FHIR resources through full CRUD tools, with document ingestion, semantic search, LOINC terminology lookup, and OAuth2-authenticated FHIR API integration.
      -