Сервер Azure AHDS FHIR MCP 🚀

Name: Azure AHDS FHIR MCP Server
Author: erikhoward

Реализация сервера Model Context Protocol (MCP) для Azure Health Data Services FHIR (Fast Healthcare Interoperability Resources). Эта служба предоставляет стандартизированный интерфейс для взаимодействия с серверами Azure FHIR, позволяя выполнять операции с данными здравоохранения с помощью инструментов MCP.

Лицензия Версия Python МКП

Настройка 🛠️

Установка 📦

Требуется Python 3.13 или выше.

Установите пакет с помощью pip :

pip install azure-fhir-mcp-server

Конфигурация MCP ⚙️

Конфигурация рабочего стола Клода

1 - Изменить конфигурацию рабочего стола Клода:

Откройте 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`	URL-адрес сервера Azure FHIR	Необходимый
`clientId`	Идентификатор клиента OAuth2	Необходимый
`clientSecret`	Секрет клиента OAuth2	Необходимый
`tenantId`	Идентификатор клиента Azure AD	Необходимый

2 — Перезапустите Claude Desktop.

Доступные инструменты 🔧

Операции с ресурсами FHIR

search_fhir — Поиск ресурсов FHIR на основе словаря параметров поиска

Доступ к ресурсам

Сервер обеспечивает доступ ко всем стандартным ресурсам FHIR через протокол ресурсов MCP:

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 — Создайте и активируйте виртуальную среду:

Linux/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.