Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

MCP Server

The package ships a thin stdio MCP server over the same deterministic package operations and JSON result contracts.

Alignment Rule

The implementation rule is:

  • one package API function
  • one CLI command
  • one MCP tool

with the same conceptual inputs and the same JSON result payload.

Tool Mapping

Package APICLI commandMCP toolResult type
assessassessassessassessment_result
coveragecoveragecoveragecoverage_result
comparecomparecomparecomparison_result
prioritizeprioritizeprioritizeprioritization_result
schemaschemaschemaschema_result
vocabularyvocabularyvocabularyvocabulary_result
templatetemplatetemplatetemplate_result
capabilitiescapabilitiescapabilitiescapabilities_result
summarizesummarizesummarizesummary_result

Result Contract

The MCP server reuses the same result-envelope style already used by the package:

  • result_type
  • inputs
  • content
  • diagnostics

This applies to analytical results and now also to discovery-style results.

Discovery Bridge

capabilities is the main bridge for MCP-aware agent tooling.

It now states, for each operation:

  • the CLI command name
  • the package API function name
  • the MCP tool name
  • the conceptual inputs
  • stable input-field descriptions
  • the emitted result type

That means the MCP wrapper does not invent a second command catalog.

The current package/CLI names remain the source of truth. The input_fields entries in capabilities are descriptive metadata for agent tooling and MCP schema generation; they do not introduce a second invocation API.

Runtime Shape

  • local Python entry point: dpawb-mcp
  • transport: stdio
  • message framing: newline-delimited JSON-RPC 2.0
  • exposed MCP capability: tools
  • current tool set: assess, coverage, compare, prioritize, schema, vocabulary, template, capabilities, summarize

Access And Discovery

The MCP identity is:

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

The server is discoverable in the official MCP Registry by searching for io.github.CE-RISE-software/dpawb.

Registry discovery page:

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

Minimal local client configuration:

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

Packaging And Publication

The MCP server has two runtime paths:

  • local Python installation through the dpawb package
  • GitHub Container Registry image for MCP-oriented distribution from the GitHub mirror

The repository includes placeholder MCP registry metadata in server.json. The publish workflow writes the release version and OCI image tag before uploading to the official MCP Registry with GitHub OIDC.