Реализация сервера Model Context Protocol (MCP) для Azure Health Data Services (FHIR) Данная услуга предоставляет стандартизированный интерфейс для взаимодействия с серверами Azure FHIR, позволяющий осуществлять операции с медицинскими данными с помощью инструментов MCP.

Настройка ️

###Установка

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

Сначала установите uv.

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

См. руководство по [[Т1]]: [[Т2]]

Credentials Flow (по умолчанию):

• Используется для служебной аутентификации
• Оставить [[Т3]] Сохраняйте HTTP_TRANSPORT=false, чтобы использовать транспорт
• Использует поток учетных данных клиентов Azure AD

Скриншоты из игры OAuth On-Behalf-Of Flow:

#####Создайте приложение Azure

Поток OAuth требует конфиденциального приложения Azure AD, которое представляет сервер MCP.

1.На портале Azure перейдите к Microsoft Entra ID . Регистрация приложений . Новая регистрация. Дайте ему описательное имя, такое как FHIR-MCP-Server, установите ** Поддерживаемые типы учетных записей ** для *Единого арендатора * и оставьте URI перенаправления незагруженным на данный момент. 2.

Azure AHDS FHIR MCP Server 🚀

A Model Context Protocol (MCP) server implementation for Azure Health Data Services FHIR (Fast Healthcare Interoperability Resources). This service provides a standardized interface for interacting with Azure FHIR servers, enabling healthcare data operations through MCP tools.

Setup 🛠️

Installation 📦

Requires Python 3.13 or higher and uv.

Install uv first.

Configuration ⚙️

See the FastMCP guidance on mcp.json here: https://gofastmcp.com/integrations/mcp-json-configuration

Client Credentials Flow (default):

• Used for service-to-service authentication
• Leave USE_FAST_MCP_OAUTH_PROXY=false
• Keep HTTP_TRANSPORT=false to use stdio transport
• Uses Azure AD client credentials flow

{
    "mcpServers": {
        "fhir": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "azure-fhir-mcp-server"
            ],
            "env": {
                "fhirUrl": "https://your-fhir-server.azurehealthcareapis.com/fhir",
                "clientId": "your-client-id",
                "clientSecret": "your-client-secret",
                "tenantId": "your-tenant-id"
            }
        }
    }
}

OAuth On-Behalf-Of Flow:

Create the Azure App Registration

The OAuth on-behalf-of flow requires a confidential Azure AD application that represents the MCP server.

1. In the Azure portal, go to Microsoft Entra ID ➜ App registrations ➜ New registration. Give it a descriptive name such as FHIR-MCP-Server, set Supported account types to Single tenant, and leave the redirect URI unset for now.
2. After the app is created, capture the generated Application (client) ID and Directory (tenant) ID for later use.
3. Under Expose an API, select Set for the Application ID URI and accept the suggested value api://{appId}. Add a scope named user_impersonation with admin consent display/description also set to user_impersonation.
4. Under Certificates & secrets, create a New client secret (for example FHIR-MCP-Secret-New). Copy the secret value immediately; it is required for the MCP server clientSecret setting.
5. Under Authentication, add the following Web redirect URIs to support the FastMCP OAuth proxy:
   • http://localhost:9002/auth/callback Ensure Default client type remains No so the app stays confidential.