MCP FHIR Server

@flexpa/mcp-fhir

[!警告] これは実験的なデモであり、本番環境での使用を目的としたものではありません。

これは、FHIRサーバーに接続するTypeScriptベースのMCPサーバーです。以下の方法でFHIRリソースとやり取りするためのコアMCP機能を提供します。

• URI 経由で FHIR リソースにアクセスする
• FHIRリソースの検索機能の提供

特徴

リソース

[!TIP] ここでの「リソース」とは、FHIR定義ではなくMCP定義を指します。MCPリソースは、モデルコンテキストプロトコル（MCP）の中核となるプリミティブであり、サーバーがクライアントが読み取り、LLMインタラクションのコンテキストとして使用できるデータとコンテンツを公開できるようにします。

• fhir:// URI 経由で FHIR リソースを一覧表示してアクセスする
• リソースはFHIR JSON形式で返されます
• FHIR サーバーの CapabilityStatement で利用可能なすべての FHIR リソース タイプをサポートします。

ツール

• search_fhir - FHIR リソースの検索
  • resourceTypeとsearchParamsパラメータとして受け取ります
  • FHIR検索結果を返す
• read_fhir - 個々の FHIR リソースを読み取る
  • uriパラメータとして受け取ります
  • FHIRリソースをJSON形式で返します

構成

サーバーには次の環境変数が必要です。

• FHIR_BASE_URL : FHIRサーバーのベースURL
• FHIR_ACCESS_TOKEN : 認証用の SMART on FHIR アクセストークン

発達

依存関係をインストールします:

サーバーを構築します。

自動リビルドを使用した開発の場合:

インストール

Claude Desktop で使用するには、サーバー設定を追加します。

MacOS の場合: ~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。パッケージスクリプトとして提供されているMCP Inspectorの使用をお勧めします。

インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。