Azure AHDS FHIR MCP サーバー 🚀

Azure Health Data Services FHIR（Fast Healthcare Interoperability Resources）向けのモデルコンテキストプロトコル（MCP）サーバー実装。このサービスは、Azure FHIRサーバーと対話するための標準化されたインターフェースを提供し、MCPツールを介した医療データ操作を可能にします。

ライセンス Pythonバージョン MCP

セットアップ 🛠️

インストール📦

Python 3.13 以上が必要です。

pipを使用してパッケージをインストールします。

pip install azure-fhir-mcp-server

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} - 特定の医薬品リソースにアクセスする
その他にも多数...

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 を再起動します。