FHIR

🚀 @flexpa/mcp-fhir

これは、TypeScript をベースにした MCP サーバーで、FHIR サーバーに接続します。FHIR リソースとのやり取りに必要な核心的な MCP 機能を提供します。

🚀 クイックスタート

このサーバーは、TypeScript で構築された MCP サーバーで、FHIR サーバーに接続します。以下のような FHIR リソースとのやり取りに必要な核心的な MCP 機能を提供します。

• fhir:// URI を通じて FHIR リソースにアクセスする
• FHIR リソースを検索する機能を提供する

⚠️ 重要提示

これは実験的なデモであり、本番環境での使用は推奨されません。

✨ 主な機能

リソース

💡 使用建议

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

• FHIR リソースを一覧表示し、URI でアクセスする
• FHIR JSON 形式のリソースを返す
• FHIR サーバーの CapabilityStatement で利用可能なすべての FHIR リソースタイプをサポートする

ツール

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

📦 インストール

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

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

🔧 開発

依存関係をインストールする：

npm install

サーバーをビルドする：

npm run build

自動再構築を伴う開発：

npm run watch

🔧 設定

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

• FHIR_BASE_URL: あなたの FHIR サーバーのベース URL
• FHIR_ACCESS_TOKEN: SMART on FHIR アクセストークン（認証に使用）