MCP FHIR Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Connects to SMART on FHIR servers, enabling access to healthcare data with proper authentication via access tokens.

@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 リソースの検索
    • resourceTypesearchParamsパラメータとして受け取ります
    • FHIR検索結果を返す
  • read_fhir - 個々の FHIR リソースを読み取る
    • uriパラメータとして受け取ります
    • FHIRリソースをJSON形式で返します

構成

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

  • 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 を提供します。

-
security - not tested
A
license - permissive license
-
quality - not tested

FHIR サーバーに接続し、fhir:// URI 経由で医療データにアクセスし、FHIR リソースの検索機能を提供する TypeScript ベースの MCP サーバーです。

  1. Features
    1. Resources
    2. Tools
  2. Configuration
    1. Development
      1. Installation
        1. Debugging
      ID: aske4zko9f