Clinical Handover MCP Server

Ein Model Context Protocol (MCP) Server für Agenten zur Koordination klinischer Übergaben. Er bietet strukturierte Werkzeuge für Risikoklassifizierung, SBAR-Generierung, Vollständigkeitsprüfung, Extraktion von Nachsorgeaufgaben und Verwaltung von Stationspräferenzen.

⚠️ Sicherheitshinweis: Alle Ausgaben sind lediglich Entwürfe zur Unterstützung der klinischen Kommunikation. Dieses System stellt keine Diagnosen, verschreibt keine Medikamente und trifft keine klinischen Entscheidungen. Jede Ausgabe muss vor der Verwendung in der Patientenversorgung von einer qualifizierten klinischen Fachkraft überprüft werden.

Schnellstart

Voraussetzungen

• Node.js ≥ 20

• npm ≥ 9

Installation & Build

# 1. Install dependencies
npm install

# 2. Compile TypeScript → build/
npm run build

# 3. Verify the server starts cleanly
npm start
# Expected stderr: [clinical-handover-mcp] Server running on stdio transport. Ready.
# Press Ctrl+C to stop.

Lokale Entwicklung (ohne Build-Schritt)

npm run dev          # runs src/index.ts via tsx directly

Lint (TypeScript-Typenprüfung ohne Kompilierung)

npm run lint

Mit dem MCP Inspector untersuchen

npm run inspect
# Opens MCP Inspector UI — usually at http://localhost:5173

Der Inspector ermöglicht es Ihnen, jedes Werkzeug interaktiv über eine Formular-Benutzeroberfläche aufzurufen und die rohen JSON-Antworten zu sehen. Verwenden Sie die Beispiel-Inputs in src/data/sample-handover.md als Testdaten.

Werkzeuge

Verbindung mit Claude Desktop

Hinzufügen zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "clinical-handover": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/clinical-handover-mcp-server/build/index.js"]
    }
  }
}

Ersetzen Sie /ABSOLUTE/PATH/TO/ durch den tatsächlichen Pfad und starten Sie Claude Desktop neu. Die 6 Werkzeuge erscheinen dann in der Werkzeugpalette von Claude.

Verbindung mit Agentman

Fügen Sie in Ihrer Agentman-Agentenkonfiguration diesen MCP-Server als Werkzeugquelle hinzu:

{
  "mcp_servers": [
    {
      "name": "clinical-handover",
      "transport": "stdio",
      "command": "node",
      "args": ["build/index.js"],
      "cwd": "/path/to/clinical-handover-mcp-server"
    }
  ]
}

Der Agent erkennt automatisch alle 6 Werkzeuge über das MCP-Protokoll.

Umgebungsvariablen

Kopieren Sie .env.example nach .env und füllen Sie diese bei Bedarf aus:

cp .env.example .env

Derzeit benötigt der Server keine Geheimnisse — die gesamte Logik ist lokal. Zukünftige Integrationen (z. B. Notion-Rückschreibvorgänge) würden hier Tokens hinzufügen.

Zukunft: Streamable HTTP-Bereitstellung

Der Server verwendet derzeit den stdio-Transport (am einfachsten für lokale Agenten und Claude Desktop).

Um ihn als HTTP-Endpunkt für Multi-Agenten- oder Remote-Bereitstellungen bereitzustellen:

1. Installieren Sie das HTTP-Transportpaket, sobald verfügbar:

   npm install @modelcontextprotocol/sdk-transport-http

2. Ersetzen Sie StdioServerTransport in src/index.ts durch StreamableHttpServerTransport:

   import { StreamableHttpServerTransport } from "@modelcontextprotocol/sdk-transport-http";
   const transport = new StreamableHttpServerTransport({ port: 3000 });

3. Bereitstellung hinter einem Reverse Proxy (nginx/Caddy) mit TLS.

4. Fügen Sie eine Bearer-Token-Authentifizierungs-Middleware hinzu, bevor Sie den Dienst öffentlich zugänglich machen.

Derzeit wird stdio bevorzugt — es hält die Angriffsfläche minimal und vermeidet das Management von Netzwerk-Anmeldedaten für ein klinisches Kommunikationstool.

Sicherheits-Designprinzipien

1. Keine Diagnose. Werkzeuge bewerten und klassifizieren nur zu Kommunikationszwecken — nicht zur Information für die klinische Behandlung.

2. Keine Verschreibung. Das Feld recommendation im SBAR ist ein Feld für die Übergabekommunikation, keine Verschreibung.

3. Obligatorischer Haftungsausschluss. Jede Werkzeugausgabe enthält den Sicherheitshinweis.

4. Menschliche Freigabeinstanz. update_ward_preferences schreibt niemals direkt in Notion — es entwirft Regeln zur menschlichen Überprüfung.

5. Keine PII-Speicherung. Der Server hält zwischen den Aufrufen keinen Status. Patientenidentifikatoren, die in Werkzeugaufrufen verwendet werden, werden nicht dauerhaft gespeichert.

Projektstruktur

src/
  index.ts        Entry point — stdio transport setup, graceful shutdown
  server.ts       Tool registration (MCP tool schemas + handlers)
  logic.ts        Core business logic (risk scoring, completeness, task extraction)
  formatters.ts   Output formatters (SBAR markdown, task tables, handover records)
  safety.ts       Safety disclaimer constants
  types.ts        Shared TypeScript interfaces and type aliases
  data/
    sample-handover.md   Sample handover text for testing
docs/
  CODEX_PROMPT.md  Agent system prompt reference