DICOM/HL7/FHIR Interoperability MCP Server

Instructions

Implementation Reference

• src/dicom_hl7_mcp/tools/fhir_converter.py:372-400 (handler)

  The actual implementation of the generate_sample_message tool.

  def generate_sample_message(message_type: str, scenario: str = "") -> str:
      """Generate sample HL7 messages for testing.
  
      Args:
          message_type: HL7 message type (e.g., "ADT^A01", "ORM^O01", "ORU^R01",
              "ADT^A08", "ADT^A34", "MDM^T02", "SIU^S12", "DFT^P03").
          scenario: Optional description of the scenario (e.g., "emergency CT",
              "routine MRI", "outpatient X-ray").
  
      Returns:
          Realistic sample HL7 message with meaningful test data.
      """
      premium_check = require_premium("generate_sample_message")
      if premium_check:
          return premium_check
  
      msg_type = message_type.strip().upper().replace(" ", "")
      if "^" not in msg_type:
          return f"Invalid message type '{msg_type}'. Expected format: TYPE^TRIGGER (e.g., 'ADT^A01')."
  
      now = datetime.now()
      timestamp = now.strftime("%Y%m%d%H%M%S")
      msg_ctrl_id = f"MSG{now.strftime('%Y%m%d%H%M%S%f')[:18]}"
      scenario_lower = scenario.lower()
  
      generators = {
          "ADT^A01": _gen_adt_a01,
          "ADT^A04": _gen_adt_a04,
          "ADT^A08": _gen_adt_a08,

• src/dicom_hl7_mcp/server.py:260-280 (registration)

  Registration of the generate_sample_message tool within the MCP server definition.

  Tool(
      name="generate_sample_message",
      description=(
          "[Premium] Generate realistic sample HL7 messages for testing. "
          "Supports ADT^A01, ADT^A04, ADT^A08, ADT^A03, ADT^A34, ADT^A40, "
          "ORM^O01, ORU^R01, MDM^T02, SIU^S12, DFT^P03."
      ),
      inputSchema={
          "type": "object",
          "properties": {
              "message_type": {
                  "type": "string",
                  "description": "HL7 message type (e.g., 'ADT^A01', 'ORM^O01', 'ORU^R01').",
              },
              "scenario": {
                  "type": "string",
                  "description": "Optional scenario description (e.g., 'emergency CT', 'routine MRI', 'outpatient X-ray').",
                  "default": "",
              },
          },
          "required": ["message_type"],