Health Record MCP

🚀 EHR ツールプロジェクトドキュメント

本プロジェクトは、医療健康分野において、SMART on FHIR 標準と Model Context Protocol (MCP) に基づくツールセットを提供することを目的としています。このツールを使用することで、ユーザーは様々な方法で電子健康記録 (EHR) データにアクセスし、処理することができます。

🚀 クイックスタート

本ツールを使用することで、ユーザーは様々な方法で電子健康記録 (EHR) データにアクセスし、処理することができます。

✨ 主な機能

1. SMART on FHIR 統合：SMART on FHIR 標準に準拠した ehr - sim プラットフォームとの相互作用をサポートします。
2. Model Context Protocol (MCP)：MCP プロトコルを通じて ehr - sim シミュレーターへのアクセスと制御を実現します。

📦 インストール

1. ローカル実行モード（標準入出力を通じて）

このモードは開発環境での使用に適しており、コマンドラインツールを通じてサービスを起動し、ehr - sim シミュレーターとの相互作用をサポートします。

使用手順

1. データベースの作成：

   # 例：データを data/my_record.sqlite ファイルに保存する
   bun run src/cli.ts --create-db --db ./data/my_record.sqlite
   

   ブラウザを開き、指示に従って ehr - sim シミュレーターに接続します。

2. MCP サービスの起動：

   # 例：作成済みのデータベースファイルを使用してサービスを起動する
   bun run src/cli.ts --db ./data/my_record.sqlite
   

設定要件

• 設定ファイル：ブランド設定ファイル（例：config.epicsandbox.json）を提供する必要があります。このファイルには以下の情報が含まれています。

  • url：ブランドの定義ファイルのパスを指定します（例：static/brands/epic - sandbox.json）。
  • tags：分類とフィルタリングに使用するブランドタグの配列です（例：[ "epic", "sandbox" ]）。
  • vendorConfig：SMART on FHIR クライアントの詳細情報（例：clientId, scopes）が含まれています。

• クライアント設定：

  {
    "mcpServers": {
      "local-ehr": {
        "name": "ローカル EHR 検索",
        "command": "bun", // または bun の絶対パス
        "args": [
          "/home/user/projects/smart-mcp/src/cli.ts", // cli.ts の絶対パス
          "--db",
          "/home/user/projects/smart-mcp/data/my_record.sqlite" // データベースファイルの絶対パス
        ]
      }
    }
  }
  

2. グローバル実行モード（サーバー送信イベントを通じて）

このモードは永続的なネットワークサービスを提供し、複数のクライアント接続をサポートします。サーバー送信イベント (SSE) を使用して通信を行います。

特徴

• 認証：OAuth 2.1 プロトコルを使用してクライアント認証を実現します。
• データ取得：認証プロセス中に SMART on FHIR フローを自動的に完了し、ClientFullEHR データをメモリまたは永続的なセッションに保存します。

注意事項

• 現在、OAuth 2.1 クライアントのサポートは限られており、専用の開発またはデバッグツールにのみ適用されます。
• このモードはまだ実験段階にあります。

以上がこのプロジェクトの核心内容で、主な機能、操作モード、設定要件を網羅しています。詳細を知りたい場合は、関連する技術文書を参照するか、プロジェクトのメンテナーに連絡してください。