deak-ai/openehr-mcp-server

An MCP (Model Context Protocol) server designed to interface with openEHR REST APIs, specifically the EHRbase implementation.
This server enables MCP clients like Claude Desktop to create compositions for openEHR templates and submit them to a server.
For production grade EHR integrations you must use an AI Model where you can ensure data privacy.
See https://modelcontextprotocol.io/introduction for more information about MCP.
## Version
Current version: 0.1.0
This project follows semantic versioning. For details on our versioning strategy, see VERSIONING.md.
## MCP Tools
openehrtemplatelist: List all available openEHR templates from the EHRbase server
openehrtemplateget: Retrieve a specific openEHR template by its unique identifier
openehrtemplateexamplecomposition: Generate an example openEHR composition based on a specific template
openehrehrcreate: Create a new EHR in the system
openehrehrget: Retrieve an EHR by its ID
openehrehrlist: List all available EHRs in the system
openehrehrgetbysubject: Get an EHR by subject ID and namespace
openehrcompositioncreate: Create a new openEHR composition in the Electronic Health Record
openehrcompositionget: Retrieve an existing openEHR composition by its unique identifier
openehrcompositionupdate: Update an existing openEHR composition in the Electronic Health Record
openehrcompositiondelete: Delete an existing openEHR composition from the Electronic Health Record
openehrqueryadhoc: Execute an ad-hoc AQL query against the openEHR server
## MCP Prompts
vitalsignscapture: Capture vital signs for a specific EHR ID
## MCP Resource
Not yet implemented
# Quick Start with Docker
The easiest way to get started is to use the pre-built Docker image available on Docker Hub.
## 1. Prerequisites
Ensure you have a running EHRbase server. For running one locally, see below.
## 2. Configure Claude Desktop
Edit your Claude Desktop configuration file (claudedesktopconfig.json) and add an "openEHR" configuration block inside the "mcpServers" section.
This file can usually be found in the following locations:
On macOS: ~/Library/Application Support/Claude
On Windows: %APPDATA%\Claude
json
"mcpServers": {
"openEHR": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--network=host",
"-e","EHRBASEURL=http://localhost:8080/ehrbase/rest",
"-e","EHRBASEJSONFORMAT=wtflat",
"ctodeakai/openehr-mcp-server:latest"
You can point EHRBASEURL to your own EHRbase server or use the provided docker-compose setup.
### JSON Format Configuration
The MCP server supports different JSON serialization formats for interacting with the EHRbase API. You can configure the format using the optional EHRBASEJSONFORMAT environment variable:
json
"-e", "EHRBASEJSONFORMAT=wtflat"
Available format options:
wtflat (default): Use the simplified data types (SDT) based on the flat web template format
canonical: Uses the canonical openEHR JSON format consistently across all operations
wtstructured: SDT based on the structured web template format (currently not working)
For more information on how to set up Claude Desktop with MCP servers, see https://modelcontextprotocol.io/quickstart/user.
# Setup