Azure AHDS FHIR MCP サーバー 🚀

Name: Azure AHDS FHIR MCP Server
Author: erikhoward

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