임상 인수인계 MCP 서버

임상 인수인계 조정 에이전트를 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 위험 분류, SBAR 생성, 완전성 검증, 후속 작업 추출 및 병동 선호도 관리를 위한 구조화된 도구를 제공합니다.

⚠️ 안전 주의사항: 모든 출력물은 임상 의사소통 지원을 위한 초안일 뿐입니다. 이 시스템은 진단, 처방 또는 임상적 결정을 내리지 않습니다. 모든 출력물은 환자 진료에 사용하기 전에 자격을 갖춘 임상 전문가의 검토를 거쳐야 합니다.

빠른 시작

사전 요구 사항

Node.js ≥ 20
npm ≥ 9

설치 및 빌드

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

로컬 개발 (빌드 단계 없음)

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

린트 (TypeScript 타입 체크, 출력 없음)

npm run lint

MCP 인스펙터로 검사하기

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

인스펙터를 사용하면 양식 UI를 통해 각 도구를 대화형으로 호출하고 원시 JSON 응답을 확인할 수 있습니다. 테스트 데이터로 src/data/sample-handover.md의 샘플 입력을 사용하세요.

도구

도구	목적
`classify_patient_risk`	환자 사례의 위험 점수 산정 (높음/중간/낮음/불확실)
`validate_handover_completeness`	누락된 중요 필드 확인, 0–100점 반환
`generate_follow_up_tasks`	Gmail/Fireflies/Notion 텍스트에서 우선순위 작업 추출
`build_sbar_handover`	구조화된 SBAR 인수인계 문서 형식 지정
`create_handover_record`	전체 교대 근무 인수인계 기록 작성
`update_ward_preferences`	임상의 피드백을 바탕으로 병동별 선호도 규칙 초안 작성

Claude Desktop에 연결

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows)에 추가하세요:

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

/ABSOLUTE/PATH/TO/를 실제 경로로 바꾼 후 Claude Desktop을 다시 시작하세요. 6개의 도구가 Claude의 도구 팔레트에 나타납니다.

Agentman에 연결

Agentman 에이전트 구성에서 이 MCP 서버를 도구 소스로 추가하세요:

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

에이전트가 MCP 프로토콜을 통해 6개의 도구를 자동으로 모두 검색합니다.

환경 변수

.env.example을 .env로 복사하고 필요한 경우 내용을 채우세요:

cp .env.example .env

현재 서버는 비밀 정보가 필요하지 않으며 모든 로직은 로컬에서 수행됩니다. 향후 통합(예: Notion 쓰기) 시 여기에 토큰이 추가될 것입니다.

향후 계획: 스트리밍 가능한 HTTP 배포

현재 서버는 stdio 전송을 사용합니다(로컬 에이전트 및 Claude Desktop에 가장 간단함).

다중 에이전트 또는 원격 배포를 위해 HTTP 엔드포인트로 노출하려면:

사용 가능한 경우 HTTP 전송 패키지를 설치하세요:
```
npm install @modelcontextprotocol/sdk-transport-http
```

src/index.ts의 StdioServerTransport를 StreamableHttpServerTransport로 교체하세요:

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

TLS를 사용하여 리버스 프록시(nginx/Caddy) 뒤에 배포하세요.
공개적으로 노출하기 전에 Bearer 토큰 인증 미들웨어를 추가하세요.

현재로서는 공격 표면을 최소화하고 임상 의사소통 도구에 대한 네트워크 자격 증명 관리를 피할 수 있는 stdio 방식이 선호됩니다.

안전 설계 원칙

진단 금지. 도구는 임상 치료 정보를 제공하는 것이 아니라 의사소통 목적으로만 점수를 매기고 분류합니다.
처방 금지. SBAR의 recommendation 필드는 인수인계 의사소통 필드이며 처방이 아닙니다.
필수 면책 조항. 모든 도구 출력물에는 안전 주의사항이 포함됩니다.
인적 승인 단계. update_ward_preferences는 Notion에 직접 쓰지 않으며, 사람이 검토할 규칙 초안만 작성합니다.
PII 저장 금지. 서버는 호출 간에 상태를 유지하지 않습니다. 도구 호출에 사용된 환자 식별 정보는 저장되지 않습니다.

프로젝트 구조

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