Azure AHDS FHIR MCP 서버 🚀

Azure Health Data Services FHIR(Fast Healthcare Interoperability Resources)을 위한 MCP(Model Context Protocol) 서버 구현입니다. 이 서비스는 Azure FHIR 서버와 상호 작용하기 위한 표준화된 인터페이스를 제공하여 MCP 도구를 통한 의료 데이터 운영을 지원합니다.

파이썬 버전 엠씨피

설정 🛠️

설치 📦

Python 3.13 이상이 필요합니다.

pip 사용하여 패키지를 설치하세요:

지엑스피1

MCP 구성 ⚙️

클로드 데스크톱 구성

1 - Claude 데스크톱 구성 편집:

claude_desktop_config.json 열고 다음 구성을 추가합니다.

MacOs에서 해당 파일은 다음 위치에 있습니다: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json .

Windows에서 해당 파일은 %APPDATA%\Claude Desktop\claude_desktop_config.json 에 있습니다.

{
    "mcpServers": {
        "fhir": {
            "command": "azure-fhir-mcp-server",
            "env": {
                "LOG_LEVEL": "INFO",
                "fhirUrl": "https://your-fhir-server.azurehealthcareapis.com/fhir",
                "clientId": "your-client-id",
                "clientSecret": "your-client-secret",
                "tenantId": "your-tenant-id"
            }
        }
    }
}

사용 가능한 환경 구성 변수 표는 다음과 같습니다.

변하기 쉬운	설명	기본
`LOG_LEVEL`	로깅 레벨	`INFO`
`fhirUrl`	Azure FHIR 서버 URL	필수의
`clientId`	OAuth2 클라이언트 ID	필수의
`clientSecret`	OAuth2 클라이언트 비밀번호	필수의
`tenantId`	Azure AD 테넌트 ID	필수의

2 - Claude Desktop을 다시 시작합니다.

사용 가능한 도구 🔧

FHIR 리소스 운영

search_fhir - 검색 매개변수 사전을 기반으로 FHIR 리소스 검색

리소스 액세스

서버는 MCP 리소스 프로토콜을 통해 모든 표준 FHIR 리소스에 대한 액세스를 제공합니다.

fhir://Patient/ - 모든 환자 리소스에 액세스
fhir://Patient/{id} - 특정 환자 리소스에 액세스합니다.
fhir://Observation/ - 모든 Observation 리소스에 액세스합니다.
fhir://Observation/{id} - 특정 Observation 리소스에 액세스합니다.
fhir://Medication/ - 모든 약물 리소스에 액세스하세요
fhir://Medication/{id} - 특정 약물 리소스에 액세스합니다.
그리고 더 많은 것들이 있습니다...

Related MCP server: HAPI-MCP

개발 💻

지역 개발 설정

1 - 저장소를 복제합니다.

git clone https://github.com/erikhoward/azure-fhir-mcp-server.git
cd azure-fhir-mcp-server

2 - 가상 환경 생성 및 활성화:

리눅스/macOS:

python -m venv .venv
source .venv/bin/activate

윈도우:

python -m venv .venv
.venv\Scripts\activate

3 - 종속성 설치:

pip install -e ".[dev]"

4 - 환경 변수 복사 및 구성:

cp .env.example .env

원하는 설정으로 .env를 편집하세요.

fhirUrl=https://your-fhir-server.azurehealthcareapis.com/fhir
clientId=your-client-id
clientSecret=your-client-secret
tenantId=your-tenant-id

5 - 클로드 데스크톱 구성

claude_desktop_config.json 열고 다음 구성을 추가합니다.

MacOs에서 해당 파일은 다음 위치에 있습니다: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json .

Windows에서 해당 파일은 %APPDATA%\Claude Desktop\claude_desktop_config.json 에 있습니다.

{
    "mcpServers": {
        "fhir": {
            "command": "python",
            "args": [
                "-m",
                "fhir_mcp_server.server"
            ],
            "cwd": "/path/to/azure-fhir-mcp-server/repo",
            "env": {
                "LOG_LEVEL": "DEBUG",
                "fhirUrl": "https://your-fhir-server.azurehealthcareapis.com/fhir",
                "clientId": "your-client-id",
                "clientSecret": "your-client-secret",
                "tenantId": "your-tenant-id"
            }
        }
    }
}

6 - Claude Desktop을 다시 시작합니다.