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

🚀 快速開始

使用預建的 Docker 鏡像（在 Docker Hub 上可用）是開始的最簡單方法。

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 文檔。

✨ 主要特性

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 的生命體徵

📦 安裝指南

安裝依賴項

在開始之前，請確保系統上已安裝以下軟件：

• 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 文件。

如果有任何問題或需要進一步幫助，請隨時與我們聯繫！