Azure AHDS FHIR MCP 서버

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} - 특정 약물 리소스에 액세스합니다.
그리고 더 많은 것들이 있습니다...

개발 💻

지역 개발 설정

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을 다시 시작합니다.

기여 🤝

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/AmazingFeature )
변경 사항을 커밋하세요( git commit -m '✨ Add some AmazingFeature' )
브랜치에 푸시( git push origin feature/AmazingFeature )
풀 리퀘스트 열기

라이센스 ⚖️

MIT 라이선스에 따라 라이선스가 부여되었습니다. LICENSE.md 파일을 참조하세요.

이것은 공식적인 Microsoft 또는 Azure 제품이 아닙니다.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

search_fhir

Azure Health Data Services FHIR 서버와의 표준화된 상호작용을 가능하게 하는 모델 컨텍스트 프로토콜 서버로, MCP 도구를 통해 의료 데이터 작업이 가능합니다.

Related MCP Servers

Azure OpenAI
kimtth
-
security
A
license
-
quality
A minimal server/client application implementation utilizing the Model Context Protocol (MCP) and Azure OpenAI.
Last updated -
15
Python
MIT License
Senechal MCP Server
mattjoyce
-
security
A
license
-
quality
A Model Context Protocol server that provides health data from the Senechal API to LLM applications, enabling AI assistants to access, analyze, and respond to personal health information.
Last updated -
Python
GPL 3.0
MCP FHIR Server
flexpa
-
security
A
license
-
quality
A TypeScript-based MCP server that connects to FHIR servers, allowing access to healthcare data via fhir:// URIs and providing search capabilities for FHIR resources.
Last updated -
20
JavaScript
MIT License
MCP API Service
nstanw
A
security
F
license
A
quality
A Model Context Protocol (MCP) server that interacts with system APIs, allowing users to check connections, search employees, register breakfast, and update chemical information by shifts.
Last updated -
21
26
JavaScript

View all related MCP servers

Azure AHDS FHIR MCP Server