HEORAgent MCP-Server

KI-gestützter Agent für Gesundheitsökonomie und Versorgungsforschung (HEOR) als Model Context Protocol-Server.

Automatisiert die Literaturrecherche über 41 Datenquellen, modernste Kosten-Nutzen-Modellierung, HTA-Dossier-Erstellung für NICE / EMA / FDA / IQWiG / HAS / EU JCA sowie eine persistente Projekt-Wissensdatenbank – alles aufrufbar als MCP-Tools aus Claude.ai, Claude Code und jedem MCP-kompatiblen Host.

Entwickelt für Teams in den Bereichen Pharma, Biotech, CRO und Medical Affairs, die rigorose, auditierbare HEOR-Workflows benötigen, ohne die Infrastruktur von Grund auf neu aufbauen zu müssen.

Schnellstart

Claude Code

claude mcp add heor-agent -- npx heor-agent-mcp

Starten Sie anschließend Claude Code neu.

Claude Desktop / claude.ai

Fügen Sie dies Ihrer MCP-Konfiguration hinzu:

{
  "mcpServers": {
    "heor-agent": {
      "command": "npx",
      "args": ["heor-agent-mcp"]
    }
  }
}

Überprüfung

> Run a literature search for semaglutide cost-effectiveness in T2D using PubMed and NICE TAs

Tools

literature_search

Durchsucht 41 Quellen parallel. Jeder Aufruf liefert eine Quellenauswahltabelle, die zeigt, welche der 41 Quellen verwendet wurden und warum – essenziell für HTA-Audit-Trails.

Beispielaufruf:

{
  "query": "semaglutide cardiovascular outcomes type 2 diabetes",
  "sources": ["pubmed", "clinicaltrials", "nice_ta", "cadth_reviews", "icer_reports"],
  "max_results": 20,
  "output_format": "text"
}

cost_effectiveness_model

Multi-State-Markov-Modell (Standard) oder Partitioned Survival Analysis (Onkologie), gemäß ISPOR-Good-Practice und NICE-Referenzfall (3,5 % Diskontierungssatz, Half-Cycle-Korrektur). Beinhaltet:

• PSA — 1.000–10.000 Monte-Carlo-Iterationen, Wahrscheinlichkeit der Kosteneffektivität bei WTP-Schwellenwerten

• OWSA — Einweg-Sensitivitätsanalyse mit Tornado-Zusammenfassung

• CEAC — Akzeptanzkurve für Kosteneffektivität

• EVPI — Erwarteter Wert perfekter Information

• WTP-Bewertung — Urteil gegenüber NHS (£25–35K/QALY, Stand April 2026), US-Kostenträger ($100–150K), gesellschaftliche Schwellenwerte

Beispielaufruf:

{
  "intervention": "Semaglutide 1mg SC weekly",
  "comparator": "Sitagliptin 100mg daily",
  "indication": "Type 2 Diabetes Mellitus",
  "time_horizon": "lifetime",
  "perspective": "nhs",
  "model_type": "markov",
  "clinical_inputs": { "efficacy_delta": 0.5, "mortality_reduction": 0.15 },
  "cost_inputs": { "drug_cost_annual": 3200, "comparator_cost_annual": 480 },
  "utility_inputs": { "qaly_on_treatment": 0.82, "qaly_comparator": 0.76 },
  "run_psa": true,
  "output_format": "docx"
}

hta_dossier_prep

Entwirft einreichungsfertige Abschnitte für sechs HTA-Frameworks mit Lückenanalyse:

Akzeptiert die Ausgabe von literature_search und cost_effectiveness_model.

Wissensdatenbank-Tools

Projekte befinden sich unter ~/.heor-agent/projects/{project-id}/ mit:

• raw/literature/ — automatisch befüllte Literaturrechercheergebnisse

• raw/models/ — automatisch befüllte Modellläufe

• raw/dossiers/ — automatisch befüllte Dossier-Entwürfe

• reports/ — generierte DOCX-Dateien

• wiki/ — manuell kuratiertes, Obsidian-kompatibles Markdown mit [[wikilinks]]

Übergeben Sie project: "project-id" an ein beliebiges Tool, und die Ergebnisse werden automatisch gespeichert.

Datenquellen

41 Quellen in 9 Kategorien. Jeder literature_search-Aufruf enthält eine Quellenauswahltabelle, die den Status (verwendet/nicht verwendet) und den Grund für jede Quelle anzeigt.

• PubMed — 35M+ biomedizinische Zitate (NCBI E-utilities)

• ClinicalTrials.gov — NIH/NLM Studienregister (CT.gov v2 API)

• bioRxiv / medRxiv — Biowissenschaftliche und medizinische Preprints

• ChEMBL — Wirkstoff-Bioaktivität, Mechanismen, ADMET (EMBL-EBI)

• WHO GHO — WHO Global Health Observatory

• World Bank — Demografie, Makroökonomie, Gesundheitsausgaben

• OECD Health — OECD-Gesundheitsstatistiken (Ausgaben, Personal, Ergebnisse)

• IHME GBD — Global Burden of Disease (DALYs, Prävalenz in 204 Ländern)

• All of Us — NIH Präzisionsmedizin-Kohorte

• FDA Orange Book — Arzneimittelzulassungen und therapeutische Äquivalenz

• FDA Purple Book — Zugelassene Biologika und Biosimilars

• NICE TAs (UK) · CADTH (Kanada) · ICER (US) · PBAC (Australien)

• G-BA AMNOG (Deutschland) · IQWiG (Deutschland) · HAS (Frankreich)

• AIFA (Italien) · TLV (Schweden) · INESSS (Quebec, Kanada)

• CMS NADAC (US-Arzneimittelbeschaffungskosten)

• PSSRU (UK-Einheitskosten) · NHS National Cost Collection · BNF (UK-Arzneimittelpreise)

• PBS Schedule (Australien)

• DATASUS · CONITEC · ANVISA (Brasilien)

• PAHO (Panamerikanisch) · IETS (Kolumbien) · FONASA (Chile)

• HITAP (Thailand)

• ISPOR — HEOR-Methodik und Konferenz-Abstracts

Ausgabeformate

Alle Tools unterstützen output_format:

• text (Standard) — Markdown mit formatierten Tabellen und Überschriften

• json — Strukturierte Objekte für nachgelagerte Tools

• docx — Microsoft Word-Dokument, auf Festplatte gespeichert, Pfad wird in der Antwort zurückgegeben

DOCX-Dateien werden unter ~/.heor-agent/projects/{project}/reports/ (wenn ein Projekt festgelegt ist) oder ~/.heor-agent/reports/ (global) gespeichert. Die Tool-Antwort enthält den absoluten Pfad – bereit für Einreichungen oder zum Teilen mit Stakeholdern.

Audit-Trail

Jeder Tool-Aufruf liefert einen vollständigen Audit-Datensatz:

• Quellenauswahltabelle — alle 41 Quellen mit Status (verwendet/nicht verwendet) und Grund

• Abgefragte Quellen — gesendete Abfragen, Antwortanzahl, Status, Latenz

• Einschlüsse / Ausschlüsse — Anzahl mit Gründen

• Methodik — PRISMA-Stil für Literatur, ISPOR/NICE für Ökonomie

• Annahmen — jede Annahme mit Begründung protokolliert

• Warnungen — Datenqualitäts-Flags, fehlende API-Schlüssel, fehlgeschlagene Quellen

Geeignet für die Aufnahme in Anhänge von HTA-Einreichungen.

Konfiguration

# Optional — enterprise data sources
ELSEVIER_API_KEY=...        # Embase + ScienceDirect
COCHRANE_API_KEY=...        # Cochrane Library
CITELINE_API_KEY=...        # Citeline
PHARMAPENDIUM_API_KEY=...   # Pharmapendium
CORTELLIS_API_KEY=...       # Cortellis
SERPAPI_KEY=...             # Google Scholar

# Optional — knowledge base location
HEOR_KB_ROOT=~/.heor-agent  # Default

# Optional — localhost proxy for enterprise APIs behind corporate VPN
HEOR_PROXY_URL=http://localhost:8787

# Optional — hosted tier (future)
HEOR_API_KEY=...

Web-UI

Eine begleitende Chat-Oberfläche ist verfügbar unter:

https://web-michael-ns-projects.vercel.app

• Chat mit Claude Opus 4.6 + allen 7 HEOR-Tools

• BYOK (Bring Your Own Key) — fügen Sie Ihren Anthropic-API-Schlüssel in den Einstellungen ein; er verbleibt im localStorage Ihres Browsers und wird niemals auf unseren Servern gespeichert

• Markdown-Rendering mit gestylten Tabellen, Tool-Aufruf-Karten mit Live-Fortschrittsanzeigen

• Beispiel-Prompts für gängige HEOR-Workflows

Die Web-UI ruft den gehosteten MCP-Server auf Railway zur Tool-Ausführung auf. Keine Einrichtung erforderlich – einfach API-Schlüssel hinzufügen und mit der Abfrage beginnen.

Selbst-Hosting der Web-UI

cd web
npm install
echo "ANTHROPIC_API_KEY=sk-ant-..." > .env.local  # optional server-side fallback
npm run dev -- -p 3456

Setzen Sie MCP_SERVER_URL auf Ihre eigene MCP-Server-Instanz (Standard: das öffentliche Railway-Deployment).

HTTP-Transport

Der Server unterstützt sowohl stdio (Standard, für lokale MCP-Clients) als auch Streamable HTTP (für gehostetes Deployment).

# Stdio mode (default — for Claude Code, Claude Desktop)
npx heor-agent-mcp

# HTTP mode — for hosted deployment, Smithery, web UI backend
npx heor-agent-mcp --http                    # port 8787
MCP_HTTP_PORT=3000 npx heor-agent-mcp        # custom port

HTTP-Endpunkte:

• POST/GET/DELETE /mcp — MCP Streamable HTTP-Protokoll

• GET /health — Gesundheitsprüfung

• GET /.well-known/mcp/server-card.json — Smithery-Discovery

Entwicklung

git clone https://github.com/neptun2000/heor-agent-mcp
cd heor-agent-mcp
npm install
npm test          # 244 tests across 66 suites
npm run build     # Compile TypeScript to dist/
npm run dev       # Run with tsx (no build step)

Erfordert: Node.js ≥ 20.

Architektur

┌────────────────────────────────────────────┐
│  MCP Host (Claude.ai / Claude Code / etc.) │
└────────────────┬───────────────────────────┘
                 │ stdio
┌────────────────▼──────────────────────────┐
│  heor-agent-mcp server                    │
│  ┌──────────────────────────────────────┐ │
│  │ 7 MCP tools (Zod-validated)          │ │
│  ├──────────────────────────────────────┤ │
│  │ DirectProvider (default)             │ │
│  │   ├─ 41 source fetchers              │ │
│  │   ├─ Audit builder + PRISMA trail    │ │
│  │   ├─ Markov / PartSA economic models │ │
│  │   ├─ Markdown + DOCX formatters      │ │
│  │   └─ Knowledge base (YAML + MD)      │ │
│  └──────────────────────────────────────┘ │
└───────────────────────────────────────────┘
                 │
    ┌────────────┴─────────────┐
    ▼                          ▼
┌────────────┐         ┌──────────────────┐
│ ~/.heor-   │         │ External APIs    │
│ agent/     │         │ (PubMed, NICE,   │
│ projects/  │         │  ICER, CADTH, …) │
└────────────┘         └──────────────────┘

Lizenz

MIT — siehe LICENSE.

Haftungsausschluss

Alle Ausgaben sind vorläufig und dienen nur der Forschungsorientierung. Ergebnisse erfordern vor der Verwendung in HTA-Einreichungen, Preisverhandlungen, regulatorischen Einreichungen oder klinischen Entscheidungen die Validierung durch einen qualifizierten Gesundheitsökonomen. Dieses Tool ersetzt keine professionelle HEOR-Expertise.

Distribution

Links

• npm: https://www.npmjs.com/package/heor-agent-mcp

• GitHub: https://github.com/neptun2000/heor-agent-mcp

• Smithery: https://smithery.ai/servers/neptun2000-70zu/heor-agent-mcp

• Web UI: https://web-michael-ns-projects.vercel.app

• Issues: https://github.com/neptun2000/heor-agent-mcp/issues