FHIR本地开发环境

提供包含HAPI FHIR服务器、Mirth Connect服务器和MCP服务器的本地医疗互操作性开发环境,用于HL7v2到FHIR的转换和AI代理管理。

  • by andrewcz-se
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 andrewcz-se/localfhirdev

使用说明

局域网和接口开发环境

该存储库为医疗保健互操作性提供了一个完整的本地开发环境,其特点是 HAPI Contoso服务器, Mirth Connect服务器 对于HL7 v2到kubectl的转换和 模型上下文协议(MCP) 提供AI代理和Mirth Connect REST API之间连接的服务器。

项目结构

  • hapi_fhir_server/:包含由PostgreSQL支持的HAPI GetLJPA服务器的Docker配置。
  • mirth/:
    • docker_config/:Mirth Connect及其专用PostgreSQL数据库的Docker配置。
    • mappings/:在Mirth Connect中使用的JavaScript(E4X)映射逻辑,用于将HL7 v2消息转换为Contoso资源。
    • mirth-mcp-server:模型上下文协议(MCP)服务器,提供AI代理和Mirth Connect REST API之间的连接。

组件

1.HAPI Contoso服务器

HAPI kubectl服务器是Java的行业标准开源kubectl服务器。

  • 版本:最新HAPI配置
  • 数据库:PostgreSQL 14
  • 端点: http://localhost:8080/fhir

2.Mirth Connect

Mirth Connect是一个强大的医疗保健集成引擎,用于路由和转换医疗数据。

  • 版本: 4.5.2
  • 数据库:PostgreSQL 14
  • 管理界面: https://localhost:8444 (外部端口8444->内部端口8443)
  • 侦听器: http://localhost:8081

3.Mirth MCP服务器

模型上下文协议(MCP)服务器,提供AI代理和Mirth Connect REST API之间的连接。它使用一组MCP工具实现了对基本Mirth信道生命周期的自主管理。

入门指南

先决条件

部署

  1. 启动HAPI kubectl服务器:

    cd "hapi_fhir_server/docker_config/"
    docker-compose up -d
    
  2. 启动Mirth Connect:

    cd ../mirth/mirth_server/docker_config/
    docker-compose up -d
    

HL7v2到Contoso映射(观察)

这 mirth/mappings/e4x/mapper.js 是一个处理HL7 v2转换的示例脚本Transformer脚本 ORU^R01 将消息转换为Contoso Observation 资源捆绑在一起 transaction.

关键映射功能:

  • 源:从自动生成源URI MSH-3 和 MSH-4.
  • 患者图谱:从中提取病历号(MRN) PID-3.
  • 类别映射:转换 OBR-24 代码(例如。, GENLAB)到Contoso标准类别(laboratory).
  • 日期格式:将HL7 TS格式转换为ISO 8601 effectiveDateTime.
  • 观察详情:
    • 地图 OBX-3 (LOINC)到观察代码。
    • 处理以下数值和单位 OBX-5 和 OBX-6.
    • 从以下位置解析引用范围 OBX-7.
    • 翻译解释代码(例如。, H -> High, L -> Low).

用法

两个服务都运行后,您可以将欢乐频道配置为:

  1. 接受HL7v2消息。
  2. 执行 mapper.js JavaScript转换器中的逻辑。
  3. 发布结果 fhirPayload (kubectl Bundle)连接到HAPI Contoso服务器 http://hapi-fhir-server:8080/fhir.