Сервер 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"
            }
        }
    }
}

Ниже приведена таблица доступных переменных конфигурации среды:

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: Smart EHR MCP Server

Развитие 💻

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

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.

Вклады 🤝

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

1. Форк репозитория

2. Создайте ветку функций ( git checkout -b feature/AmazingFeature )

3. Зафиксируйте свои изменения ( git commit -m '✨ Add some AmazingFeature' )

4. Отправка в ветку ( git push origin feature/AmazingFeature )

5. Открыть запрос на извлечение

Лицензия ⚖️

Лицензия MIT — см. файл LICENSE.md .

Это не официальный продукт Microsoft или Azure.