Healthcare FHIR MCP 서버

의료 AI 애플리케이션을 위한 FHIR R4(Fast Healthcare Interoperability Resources) MCP 서버입니다. 모든 FHIR R4 호환 서버에서 환자, 질환, 약물, 관찰 데이터 및 치료 계획을 검색할 수 있으며, AI가 생성한 임상 데이터에 대한 케어 기반 안전성 검증 기능을 제공합니다.

MEOK AI Labs에서 제작했습니다. MEOK AI Labs는 MEOK AI OS와 Sovereign Temple 케어 멤브레인 프레임워크를 개발한 팀입니다.

이 서버가 필요한 이유

의료 AI는 임상 데이터에 대한 구조화된 접근이 필요하지만, 기존 도구들은 AI가 생성한 콘텐츠에 대한 안전 가드레일이 부족합니다. 이 서버는 AI가 생성한 관찰 데이터를 건강 기록에 반영하기 전에 생리학적 안전 범위 내에 있는지 검증합니다. MEOK의 케어 멤브레인 프레임워크에서 영감을 받아, 심박수 500bpm이나 체온 90도와 같이 불가능한 활력 징후를 AI가 기록하지 못하도록 방지합니다.

도구

설치

pip install mcp requests

구성

FHIR_SERVER_URL 환경 변수를 FHIR R4 서버 엔드포인트로 설정하세요.

공개 테스트 서버

개발 및 테스트를 위해 다음 공개 FHIR R4 서버를 사용할 수 있습니다:

• HAPI FHIR: https://hapi.fhir.org/baseR4

• SMART Health IT: https://r4.smarthealthit.org

사용법

서버 실행

FHIR_SERVER_URL=https://hapi.fhir.org/baseR4 python server.py

Claude Desktop 설정

~/.claude/claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "healthcare-fhir": {
      "command": "python",
      "args": ["/path/to/healthcare-fhir-mcp/server.py"],
      "env": {
        "FHIR_SERVER_URL": "https://hapi.fhir.org/baseR4"
      }
    }
  }
}

호출 예시

환자 검색:

Tool: search_patients
Input: {"name": "Smith", "count": 5}
Output: {"total": 142, "patients": [{"id": "123", "name": "John Smith", "birthDate": "1980-03-15", ...}]}

질환 가져오기:

Tool: search_conditions
Input: {"patient_id": "123", "clinical_status": "active"}
Output: {"total": 3, "conditions": [{"display": "Type 2 diabetes", "code": "44054006", ...}]}

안전성 검증을 통한 관찰 데이터 생성:

Tool: create_observation
Input: {"patient_id": "123", "loinc_code": "8867-4", "display_name": "Heart rate", "value": 72, "unit": "bpm"}
Output: {"created": true, "id": "456", "validation": {"valid": true, "safety_check": "passed"}}

안전하지 않은 관찰 데이터 거부:

Tool: create_observation
Input: {"patient_id": "123", "loinc_code": "8867-4", "display_name": "Heart rate", "value": 500, "unit": "bpm"}
Output: {"created": false, "validation": {"valid": false, "errors": ["SAFETY: Heart rate value 500 is outside safe range (30-220 bpm)"]}}

케어 기반 안전성 검증

케어 멤브레인은 AI가 생성한 임상 관찰 데이터를 알려진 생리학적 범위와 비교하여 검증합니다:

이 범위를 벗어나는 값은 설명과 함께 거부됩니다. 또한 AI가 생성한 관찰 데이터가 final 상태(임상의가 검증한 데이터에만 사용되어야 함)를 사용하는 경우 플래그가 지정됩니다.

보안 고려 사항

• PHI 처리: 이 서버는 개인 건강 정보(PHI)를 포함할 수 있는 FHIR 서버에 연결됩니다. 배포 환경이 HIPAA, GDPR 또는 관련 규정을 준수하는지 확인하십시오.

• 인증: 프로덕션 FHIR 서버에는 FHIR_AUTH_TOKEN을 사용하십시오. 실제 환자 데이터가 있는 곳에 공개 테스트 서버를 절대 사용하지 마십시오.

• 전송 보안: 프로덕션 환경의 FHIR 서버 URL에는 항상 HTTPS를 사용하십시오.

• AI 생성 데이터: create_observation을 통해 생성된 모든 관찰 데이터는 안전 범위에 대해 검증되며 기본적으로 preliminary 상태로 설정됩니다. AI는 임상 데이터에 final 상태를 설정해서는 안 됩니다.

• 감사: 규정 준수를 위해 FHIR 서버의 감사 로깅(AuditEvent 리소스)을 활성화하는 것을 고려하십시오.

• 접근 제어: MCP 서버는 FHIR 인증 토큰의 권한을 상속받습니다. 최소 권한의 원칙을 따르십시오.

• 속도 제한: 내장된 속도 제한 기능이 남용을 방지합니다. 무료 티어는 일일 100회 호출, 프로 티어는 일일 10,000회 호출을 허용합니다.

지원되는 FHIR R4 리소스

• Patient

• Condition

• MedicationRequest

• Observation

• CarePlan

추가 리소스 유형은 validate_resource 도구를 통해 구조적 검증을 수행할 수 있습니다.

가격

엔터프라이즈 티어에는 HIPAA 적용 대상 기관을 위한 비즈니스 제휴 계약(BAA)이 포함됩니다.

라이선스

MIT