Openehr MCP Server

🚀 openEHR MCP サーバ

openEHR MCP サーバは、Model Context Protocol (MCP) をベースに構築されたサーバで、openEHR REST API（特に EHRbase の実装）との相互作用を可能にします。このサーバを使用することで、MCP クライアント（例えば Claude Desktop）が openEHR テンプレートを作成し、サーバに送信することができます。

本番レベルの EHR 統合においては、データのプライバシーを確保できる AI モデルの使用が必須です。

MCP に関する詳細情報は、こちらを参照してください：https://modelcontextprotocol.io/introduction

✨ 主な機能

MCP ツール

• openehr_template_list：EHRbase サーバ上のすべての利用可能な openEHR テンプレートを一覧表示します。
• openehr_template_get：一意の識別子を使用して特定の openEHR テンプレートを取得します。
• openehr_template_example_composition：特定のテンプレートに基づいてサンプルの openEHR コンポジションを生成します。
• openehr_ehr_create：新しい EHR を作成します。
• openehr_ehr_get：ID を使用して EHR を取得します。
• openehr_ehr_list：システム内のすべての利用可能な EHR を一覧表示します。
• openehr_ehr_get_by_subject：サブジェクト ID と名前空間を使用して EHR を取得します。
• openehr_composition_create：電子カルテに新しい openEHR コンポジションを作成します。
• openehr_composition_get：一意の識別子を使用して既存の openEHR コンポジションを取得します。
• openehr_composition_update：既存の openEHR コンポジションを更新します。
• openehr_composition_delete：電子カルテから既存の openEHR コンポジションを削除します。
• openehr_query_adhoc：openEHR サーバに対して即席の AQL クエリを実行します。

MCP ヒント

• vital_signs_capture：特定の EHR ID のバイタルサインを取得します。

MCP リソース

未実装です。

📦 インストール

Docker を使用したクイックスタート

Docker Hub で利用可能な事前構築済みの Docker イメージを使用するのが、最も簡単な開始方法です。

1. 前提条件

動作中の EHRbase サーバが必要です。必要に応じて、ドキュメントのセットアップガイドを参照してください。

2. Docker のインストール

公式ドキュメントに従って Docker 環境をインストールし、設定してください：https://docs.docker.com/get-docker/

3. Docker イメージの取得

Docker Hub から openEHR MCP Server イメージをダウンロードします：

docker pull openehr-mcp-server:latest

4. Docker コンテナの実行

コンテナを対話モードで実行し、ホストネットワークに接続します：

docker run -it --network host openehr-mcp-server:latest

これにより MCP サーバが起動し、ターミナルにログ出力が表示されます。デフォルトでは、サーバは http://localhost:8080 で動作します。

5. インストールの検証

ブラウザまたはコマンドラインツールを使用して http://localhost:8080 にアクセスしてください。MCP サーバのウェルカムページまたは API ドキュメントが表示されるはずです。

手動インストールと設定

依存関係のインストール

開始する前に、システムに以下のソフトウェアがインストールされていることを確認してください：

• Python 3.6 以上
• pip（Python パッケージマネージャ）
• Docker（コンテナ化されたデプロイを使用する場合）

リポジトリのクローン

GitHub からこのリポジトリをクローンします：

git clone https://github.com/yourusername/openehr-mcp-server.git
cd openehr-mcp-server

Python パッケージのインストール

プロジェクトのルートディレクトリで、必要な Python パッケージをインストールします：

pip install -r requirements.txt

設定の構成

config.py ファイルを作成するか（または既存のサンプル設定ファイルをコピー）、必要に応じて調整します。

# config.py の例
DEBUG = True
PORT = 8080
HOST = 'localhost'

サーバの起動

以下のコマンドを実行して MCP サーバを起動します：

python app.py

サーバは指定されたポートで起動し、リクエストを処理する準備ができます。

📚 ドキュメント

コマンドラインツール

すべての MCP ツールはコマンドラインから使用できます。例えば：

すべてのテンプレートを一覧表示

openehr_template_list --server http://localhost:8080

新しい EHR を作成

openehr_ehr_create --subject-id "patient_1234" --server http://localhost:8080

API ドキュメント

完全な API ドキュメントは、Swagger UI を通じてアクセスできます：http://localhost:8080/swagger

🔧 テスト

単体テスト

以下のコマンドを実行して単体テストを実行します：

pytest tests/test_*.py -v

これによりすべてのテストケースが実行され、詳細な結果が出力されます。

統合テスト

統合環境でより包括的なテストを実行します：

pytest integration_tests/ --cov=openehr_mcp_server

トラブルシューティング

問題が発生した場合は、以下を確認してください：

1. Docker が正しくインストールされ、実行されていることを確認してください。
2. コンテナのログ出力を確認し、エラー情報を取得してください：

   docker logs <container-id>
   

3. サーバのログファイル（通常は logs/ ディレクトリにあります）を確認してください。

コントリビューションガイド

プロジェクトに貢献したい場合は、以下の手順に従ってください：

1. リポジトリを Fork します。
2. 新しい機能ブランチを作成します：

   git checkout -b feature/<your-feature>
   

3. 変更をコミットし、メインブランチに対して Pull Request を作成します。
4. Pull Request で変更内容を詳細に説明してください。

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。詳細については、LICENSE ファイルを参照してください。

何か質問や追加の支援が必要な場合は、いつでもお問い合わせください！