HL7 Tools — Parser, Validator, FHIR R4 Converter

HL7 Tools — MCP サーバー + REST API

HL7 v2.x パーサー、ビューアー、バリデーター、テストメッセージ生成ツール、FHIR R4 コンバーターです。

機能

• 解析 生の HL7 v2 パイプ区切りメッセージを、名前付きフィールドを含む構造化 JSON に変換します
• 説明 メッセージの各フィールドを人が読みやすい説明で解説します（CARISTIX 形式）
• 検証 20 種類以上のメッセージタイプについて、セグメント／フィールドの要件に照らしてメッセージを検証します
• 生成 ADT、ORM、ORU、SIU、MDM、DFT、VXU のリアルなテストメッセージを生成します
• 差分比較 2 つの HL7 メッセージを比較して、フィールドレベルの違いを見つけます
• 変換 HL7 v2 を FHIR R4 バンドルに変換します（10 種類のリソースマッピング）
• 変換 FHIR R4 バンドルを HL7 v2 に戻します
• 検索 バージョン 2.3～2.8 の任意のセグメントまたはフィールド定義を検索します

対応セグメント（完全な定義付きで 20 種類）

MSH、EVN、PID、PD1、NK1、PV1、PV2、IN1、GT1、DG1、ORC、OBR、OBX、AL1、SCH、NTE、FT1、PR1、RXA、RXE

クイックスタート

npm install
npm run dev       # HTTP mode on port 3200
npm start         # stdio mode (for MCP clients)

MCP ツール

ツール	説明
hl7_parse	HL7 v2 メッセージを構造化 JSON に解析します
hl7_explain	すべてのフィールドを人が読みやすく解説します
hl7_validate	メッセージの構造と必須フィールドを検証します
hl7_generate	架空のデータを含むサンプルメッセージを生成します
hl7_diff	2 つのメッセージをフィールド単位で比較します
hl7_to_fhir	HL7 v2 を FHIR R4 バンドルに変換します
fhir_to_hl7	FHIR R4 バンドルを HL7 v2 に変換します
hl7_segments	すべてのセグメントとフィールド数を一覧表示します
hl7_field_info	特定のフィールド定義を検索します

REST API

POST /parse       — Parse a message
POST /explain     — Explain a message
POST /validate    — Validate a message
POST /generate    — Generate a test message
POST /diff        — Diff two messages
POST /to-fhir     — Convert HL7 to FHIR
POST /to-hl7      — Convert FHIR to HL7
GET  /segments    — List segments (?version=2.5.1)
GET  /field       — Field info (?segment=PID&field=3)
GET  /health      — Health check
GET  /            — API info