Servidor MCP de Traspaso Clínico

Un servidor del Protocolo de Contexto de Modelo (MCP) para agentes de coordinación de traspaso clínico. Proporciona herramientas estructuradas para la clasificación de riesgos, generación de SBAR, validación de integridad, extracción de tareas de seguimiento y gestión de preferencias de sala.

⚠️ Aviso de seguridad: Todos los resultados son solo borradores de apoyo a la comunicación clínica. Este sistema no diagnostica, prescribe ni toma decisiones clínicas. Cada resultado debe ser revisado por un profesional clínico cualificado antes de su uso en la atención al paciente.

Inicio rápido

Requisitos previos

Node.js ≥ 20
npm ≥ 9

Instalación y compilación

# 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.

Desarrollo local (sin paso de compilación)

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

Lint (verificación de tipos de TypeScript sin emitir)

npm run lint

Inspeccionar con el Inspector MCP

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

El inspector le permite llamar a cada herramienta de forma interactiva con una interfaz de usuario de formulario y ver las respuestas JSON sin procesar. Utilice las entradas de muestra en src/data/sample-handover.md como datos de prueba.

Herramientas

Herramienta	Propósito
`classify_patient_risk`	Evaluar el riesgo de un caso de paciente (alto/medio/bajo/incierto)
`validate_handover_completeness`	Comprobar si faltan campos críticos, devolver una puntuación de 0 a 100
`generate_follow_up_tasks`	Extraer tareas priorizadas de texto de Gmail/Fireflies/Notion
`build_sbar_handover`	Formatear un documento de traspaso SBAR estructurado
`create_handover_record`	Ensamblar un registro completo de traspaso de turno
`update_ward_preferences`	Redactar reglas de preferencia específicas de la sala a partir de comentarios de los médicos

Conectar a Claude Desktop

Añada a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Reemplace /ABSOLUTE/PATH/TO/ con la ruta real, luego reinicie Claude Desktop. Las 6 herramientas aparecerán en la paleta de herramientas de Claude.

Conectar a Agentman

En la configuración de su agente Agentman, añada este servidor MCP como fuente de herramientas:

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

El agente descubrirá automáticamente las 6 herramientas a través del protocolo MCP.

Variables de entorno

Copie .env.example a .env y rellénelo si es necesario:

cp .env.example .env

Actualmente, el servidor no necesita secretos: toda la lógica es local. Las integraciones futuras (por ejemplo, escritura de vuelta en Notion) añadirían tokens aquí.

Futuro: Despliegue HTTP transmitible

El servidor utiliza actualmente el transporte stdio (el más sencillo para agentes locales y Claude Desktop).

Para exponerlo como un punto final HTTP para despliegues multi-agente o remotos:

Instale el paquete de transporte HTTP cuando esté disponible:
```
npm install @modelcontextprotocol/sdk-transport-http
```

Reemplace StdioServerTransport en src/index.ts con StreamableHttpServerTransport:

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

Despliegue detrás de un proxy inverso (nginx/Caddy) con TLS.
Añada un middleware de autenticación de token de portador antes de exponerlo públicamente.

Por ahora, se prefiere stdio: mantiene la superficie de ataque mínima y evita la gestión de credenciales de red para una herramienta de comunicación clínica.

Principios de diseño de seguridad

Sin diagnóstico. Las herramientas puntúan y clasifican solo con fines de comunicación, no para informar sobre el tratamiento clínico.
Sin prescripción. El campo recommendation en SBAR es un campo de comunicación de traspaso, no una prescripción.
Descargo de responsabilidad obligatorio. Cada resultado de la herramienta lleva el aviso de seguridad.
Puerta de aprobación humana. update_ward_preferences nunca escribe en Notion directamente; redacta reglas para la revisión humana.
Sin almacenamiento de PII. El servidor no mantiene ningún estado entre llamadas. Los identificadores de pacientes utilizados en las llamadas a herramientas no se conservan.

Estructura del proyecto

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

Clinical Handover MCP Server