@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形式で返します

Related MCP server: Myrcael

構成

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

• FHIR_BASE_URL : FHIRサーバーのベースURL

• FHIR_ACCESS_TOKEN : 認証用の SMART on FHIR アクセストークン

発達

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

npm install

サーバーを構築します。

npm run build

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

npm run watch

インストール

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

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

{
  "mcpServers": {
    "fhir": {
      "command": "/path/to/@flexpa/mcp-fhir/build/index.js"
    },
    "env": {
      "FHIR_BASE_URL": "<FHIR_BASE_URL>",
      "FHIR_ACCESS_TOKEN": "<FHIR_ACCESS_TOKEN>"
    }
  }
}

デバッグ

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

npm run inspector

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