Digital Passport Model Assessment Workbench

A Python toolkit and thin CLI for SHACL-based assessment of digital passport data models, pairwise comparison of composed solutions, and SHACL-only use-case coverage analysis.

This README is primarily a repository and development entry point. The user-facing conceptual and usage reference is at the published documentation site. The repository-source docs remain available in docs/.

What this repository contains

• A publishable Python package with a CLI entry point: dpawb
• A thin stdio MCP server entry point: dpawb-mcp
• Contract-aligned input schemas for composition profiles, use cases, and alignments
• Built-in vocabularies and templates exposed through discovery commands
• Synthetic local fixtures used only for tests and validation
• A progression-based examples tree for human and AI-agent tutorials

Tool Shape

The tool is designed primarily as an agent-usable analytical toolkit with a thin CLI. The core command surface is:

• assess
• coverage
• compare
• prioritize
• schema
• vocabulary
• template
• capabilities
• summarize

AI-agent use

The intended primary integration mode is an AI agent orchestrating the analytical pipeline through the package API or the CLI. In practice, this means:

• deterministic file-based inputs
• JSON outputs suitable for agent parsing and chaining
• explicit analytical steps instead of a chat-oriented interface

The CLI remains useful for direct human invocation, but the main product shape is an analytical engine that can be called by agent skills, workflow runners, or tool adapters.

The package also ships a thin stdio MCP server over the same deterministic command surface:

• assess
• coverage
• compare
• prioritize
• schema
• vocabulary
• template
• capabilities
• summarize

The MCP surface stays intentionally thin:

• keep dpawb as the core Python package
• expose the same operations through dpawb-mcp
• ship the MCP runtime as both a local Python entry point and a GitHub Container Registry image
• publish registry metadata from the GitHub mirror

The MCP runtime and publication shape are documented in the published MCP server page.

The public Python API is documented in the published API reference.

MCP Access

The MCP server is published with this identity:

• registry name: io.github.CE-RISE-software/dpawb
• OCI image pattern: ghcr.io/ce-rise-software/dpawb-mcp:<release-version>
• transport: stdio
• official registry base: https://registry.modelcontextprotocol.io/

The server is discoverable in the official MCP Registry under the name io.github.CE-RISE-software/dpawb.

Registry discovery page:

• https://registry.modelcontextprotocol.io/?q=dpawb

Local client configuration example:

{
  "mcpServers": {
    "dpawb": {
      "command": "dpawb-mcp"
    }
  }
}

OCI-oriented registry metadata is declared in server.json. The publish workflow fills in the release version and image tag when publishing.

Install

python -m venv .venv
. .venv/bin/activate
pip install -e .

Published package name:

pip install dpawb

The installed MCP server command is:

dpawb-mcp

If you are working in a restricted environment, the package is configured to build with setuptools so editable install

... View full README on GitHub