@flexpa/mcp-fhir

[!경고] 이것은 실제 운영에 사용하기 위한 실험적 데모가 아닙니다.

FHIR 서버에 연결되는 TypeScript 기반 MCP 서버입니다. 다음과 같은 방법으로 FHIR 리소스와 상호 작용할 수 있는 핵심 MCP 기능을 제공합니다.

• URI를 통해 FHIR 리소스에 액세스
• FHIR 리소스에 대한 검색 기능 제공

특징

자원

[!TIP] 여기서 "리소스"는 FHIR 정의 가 아닌 MCP 정의를 의미합니다. MCP 리소스는 모델 컨텍스트 프로토콜(MCP)의 핵심 요소로, 서버가 클라이언트가 읽고 LLM 상호 작용의 컨텍스트로 사용할 수 있는 데이터와 콘텐츠를 노출할 수 있도록 합니다.

• fhir:// URI를 통해 FHIR 리소스를 나열하고 액세스합니다.
• 리소스는 FHIR JSON 형식으로 반환됩니다.
• FHIR 서버의 CapabilityStatement에서 사용 가능한 모든 FHIR 리소스 유형을 지원합니다.

도구

• search_fhir - FHIR 리소스 검색
  • resourceType 및 searchParams 매개변수로 사용합니다.
  • FHIR 검색 결과를 반환합니다.
• read_fhir - 개별 FHIR 리소스 읽기
  • uri 매개변수로 사용합니다
  • JSON 형식으로 FHIR 리소스를 반환합니다.

구성

서버에는 다음과 같은 환경 변수가 필요합니다.

• FHIR_BASE_URL : FHIR 서버의 기본 URL
• FHIR_ACCESS_TOKEN : 인증을 위한 FHIR 액세스 토큰의 SMART

개발

종속성 설치:

지엑스피1

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

설치

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.