Сервер Azure AHDS FHIR MCP

Сервер Azure AHDS FHIR MCP 🚀

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

Настройка 🛠️

Установка 📦

Требуется 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} — доступ к определенному ресурсу по лекарствам
И многое другое...

Развитие 💻

Настройка локального развития

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.

Вклады 🤝

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Форк репозитория
Создайте ветку функций ( 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

Сервер протокола контекста модели, который обеспечивает стандартизированное взаимодействие с серверами FHIR служб данных здравоохранения Azure, позволяя выполнять операции с данными здравоохранения с помощью инструментов MCP.

Related MCP Servers

Smart EHR MCP Server
jmandel
-
security
F
license
-
quality
A Model Context Protocol server that connects AI tools to Electronic Health Records using SMART on FHIR, allowing secure searching, querying, and analysis of patient data from compatible EHRs.
Last updated -
48
TypeScript
HAPI-MCP
ericmc21
-
security
F
license
-
quality
A Model Context Protocol server that enables querying FHIR healthcare data using natural language, allowing doctors to retrieve patient information, medications, observations, and other healthcare records.
Last updated -
1
Python
Medplum MCP Server
rkirkendall
A
security
A
license
A
quality
A Model Context Protocol server that enables natural language commands to manage healthcare data stored in Medplum FHIR servers through standardized Create, Read, Update, and Search operations.
Last updated -
37
8
TypeScript
MIT License
FHIR Careplan
Kushagra-Dutta
-
security
F
license
-
quality
A comprehensive Model Context Protocol server that provides universal access to multiple FHIR servers with AI-powered clinical analysis capabilities for healthcare data integration and patient care planning.
Last updated -
2
Python

View all related MCP servers

Azure AHDS FHIR MCP Server