convez.ai
MCP ServerIntegração & APIsAvançado
Cadasto

openEHR Assistant Plugin

Cadasto/openehr-assistant-plugin

Plugin de IA para modelagem clínica openEHR e workflows de saúde

Ver no GitHub
BomPluginScore · de 0 a 100

Suite de plugin de IA para integração de workflows clínicos com sistemas openEHR, oferecendo skills, comandos e agentes para Claude Code e Cursor. Guia assistentes através de modelagem openEHR, descoberta de CKM e consultas de especificações com suporte a autoria de arquétipos, design de templates e construção de composições.

Instalação

$npx convez-ai Cadasto/openehr-assistant-plugin

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
6
Forks
0
Acompanhando
2
Saúde
100%
Último commit
há 1 mês
Versão
v0.9.2
Issues abertas
0
Contribuidores
2

Casos de uso

  • Autoria e edição de arquétipos clínicos openEHR
  • Design e construção de templates com framework CGEM
  • Escrita e otimização de queries AQL (Archetype Query Language)
  • Descoberta e busca no Clinical Knowledge Manager (CKM)
  • Geração de composições em formatos FLAT, STRUCTURED e CANONICAL

Veredito

Ferramenta especializada para profissionais e desenvolvedores em saúde digital que trabalham com padrões openEHR. Requer conhecimento prévio de modelagem clínica e sistemas interoperáveis, mas oferece automação robusta de workflows complexos.

README

A tradução para o português deste README ainda está na fila.

openEHR Assistant Plugin

License: MIT Version Claude Code Cursor openehr-assistant-mcp openEHR Keep a Changelog

AI plugin suite for clinical workflow integration with openEHR systems. Adds skills, commands, agents, and hooks for Claude Code and Cursor that guide AI assistants through openEHR modeling, CKM discovery, and specification lookups.

This plugin works with the openEHR Assistant MCP Server, which provides the tools, prompts, and resources (CKM, guides, terminology, type specs). The plugin supplies the workflow layer: when to load which guides, which commands to offer, and how to stay aligned with openEHR best practices.

Recommended: For installation, transports, and MCP client configuration of the server (hosted vs local, streamable-http vs stdio), see the openehr-assistant-mcp README — Quick Start and Common client configurations.

Table of Contents


Features

  • Guide-first workflows — Skills and commands instruct the assistant to load relevant implementation guides from the MCP server before answering.
  • Archetype authoring — Create, edit, extend, and specialize clinical archetypes with lint rules and idiom lookup.
  • Template design — Build and constrain templates using the CGEM framework and narrowing principle.
  • Composition building — Generate FLAT, STRUCTURED, and CANONICAL format instances.
  • AQL queries — Write, explain, and optimize Archetype Query Language queries.
  • CKM discovery — Search the Clinical Knowledge Manager for archetypes and templates.
  • Demographic modeling — PARTY hierarchy, roles, relationships, identity patterns.
  • Offline reference — Quick-reference, ADL/AQL syntax cheatsheets, and RM type reference in the repo when MCP is unavailable.

Installation

Claude Code — from the Cadasto marketplace:

/plugin marketplace add cadasto/plugin-marketplace
/plugin install openehr-assistant@cadasto

or directly from the repo: claude plugin add cadasto/openehr-assistant-plugin.

Cursor — Add the plugin via Cursor’s plugin flow (e.g. from a Git URL or local path). The repo includes a Cursor manifest at .cursor-plugin/plugin.json; skills, commands, agents, and MCP config are shared with the Claude plugin.

See docs/install.md for marketplace, local-development, update, and Cursor install details.

Contributors: See CONTRIBUTING.md for maintainer workflows, clone vs git archive (.gitattributes export-ignore), and how to bump compatibility with openehr-assistant-mcp.


Setup (MCP server)

This plugin expects the openEHR Assistant MCP Server to be configured in your client. The plugin ships with a default MCP config that points at the hosted server; you can override it for local or stdio use.

For server installation, transports (streamable-http vs stdio), and client-specific configuration (Claude Desktop, Cursor, LibreChat, Junie), see:

Environment variables (e.g. CKM_API_BASE_URL) and Docker/stdio details are documented in the MCP server README.

One server, not two. This plugin bundles its own .mcp.json, so it provides the openehr-assistant MCP server itself — prefer that. If you also added an openehr-assistant connector at claude.ai, the same tools appear twice (under a claude_ai namespace and the plugin's); that duplicate is optional. If a subagent reports CKM/guide tools "denied", it's a permission-policy gap, not a missing server — see the permissions.allow snippet in .claude/settings.json and docs/install.md.


Components

Skills

SkillTriggerDescription
archetype-authoringCreating/editing/reviewing/translating archetypesAuthoring, review & remediate, rationale prose, translation, CKM-import — guide-first
archetype-lintReviewing/validating archetypes22 normative lint rules with STRICT/PERMISSIVE modes
template-authoringCreating/reviewing templatesTemplate design with CGEM framework and narrowing principle
composition-builderBuilding compositionsFLAT/STRUCTURED/CANONICAL format generation
aql-authoringWriting AQL queriesQuery authoring, explanation, and optimization
demographic-modelingDesigning demographic modelsPARTY hierarchy, roles, relationships, identity patterns
openehr-assistantAny openEHR mentionClinical modeling, guide browsing, and tool routing

Commands

Multi-step workflows (authoring, review, AQL, compositions) are driven by the skills above, which auto-trigger from natural language. Commands are a small set of explicit one-shots:

CommandDescription
/ckm-search [archetype|template] <query>Find archetypes or templates in CKM (optional rmClass filter)
/openehr-explain <thing>Explain or look up any openEHR thing — archetype, template, RM/AM type, RM structural concept, ADL idiom, AQL query/keyword, or terminology code (auto-detects)
/semantic-diff <file-a> <file-b>Semantic diff of two artefacts (archetype or template); version-bump verdict or sibling/cross-artefact compatibility report
/archetype-fix-syntax <file>Fix ADL syntax errors preserving semantics
/template-from-form <form text or path>Map a clinical form to a template sketch (archetypes + narrowing)
/archetype-impact <archetype-id>Scan workspace for references to an archetype (templates incl. .t.json, parent .adl slots, AQL)

Creating/editing/reviewing archetypes (incl. rationale prose and translation), linting, authoring templates, building compositions, writing AQL, and browsing guides are handled by the matching skill (no command needed) — just describe the task.

Agents

AgentDescription
clinical-modelerLocal clinical-model file analyst (read/write/review/edit .adl/.oet/.opt). Writes locally; has read-only MCP lookups (terminology, type specs, guides, single CKM fetch) with offline fallback
ckm-scoutCKM reuse-search specialist — parallel searches, ranked recommendation
spec-researcherSpec research specialist using llms.txt/.md twin methodology

Companion MCP Server

The openehr-assistant-mcp server provides:

  • 12 MCP tools (CKM search, guide access, terminology, type specs, ADL idioms, curated examples)
  • 15 MCP prompts (guided clinical workflows)
  • Implementation guides across six categories: archetypes/, templates/, aql/, simplified_formats/, specs/ (openEHR specification digests tracking the development branch), and howto/ (toolchain how-tos)
  • Curated worked examples at openehr://examples/{kind}/{name} — AQL, FLAT, STRUCTURED payloads, and CKM-published reference .adl archetypes

Compatibility: This plugin version is built and tested against openehr-assistant-mcp v0.19.0 (releases). When updating the plugin, align with that server’s changelog so each plugin release stays compatible with a specific MCP server version.

Offline reference material in skills/openehr-assistant/reference/ includes a quick-reference (principles, rules, guide index), minimal ADL and AQL syntax cheatsheets, and an RM type reference (~30 commonly archetyped types with attributes for local lint rule 4 validation); see AGENTS.md (Syntax and grammar sources) for links to official specs and grammars.

See CHANGELOG.md for release notes.


Contributing

Contributions are welcome. Start with CONTRIBUTING.md and the docs/ references: install, testing & validation, versioning, and authoring conventions. Before opening a PR, run ./scripts/validate.sh and claude plugin validate . (CI runs the validator on every push). Please also review the Code of Conduct and Security Policy.


License

MIT License — Cadasto B.V.

Ver o original no GitHub

Bom para

Relacionados