Skip to content
S1000D StackS1000D StackS1000D Stack

Getting started

This page explains what you need before using s1000d-stack and the first steps to take. For what this set of tools does, see What S1000D Stack is.

What you need

Section titled “What you need”
flowchart LR
  A["Obtain the distribution from s1000d.org<br/>(accept the terms of use)"] --> B["Extract it into a folder<br/>extract the inner zip files too"]
  B --> C["Point S1000D_SPEC_DIR at that folder"]
  D["Your own data modules and BREX<br/>(the CSDB folder)"] --> E["Point S1000D_CSDB_DIR at it"]
  C --> F["Register s1000d-brex-mcp in your MCP client"]
  E --> F
  1. The S1000D® distribution. From the download page at s1000d.org, obtain the zip for the target issue (the first target is Issue 7) and extract it. The distribution contains the default BREX (Business Rules Exchange) data module (DMC-S1000D-*-04-10-0301-00A-022A-D_*.XML) and the XML schemas.
  2. Node.js 22 or later. The MCP servers can be started with npx.
  3. An MCP client. Something that can register MCP servers, such as Claude Desktop or Claude Code.

First steps

Section titled “First steps”

Add the following to the Claude Desktop configuration file (claude_desktop_config.json) and restart it.

{
  "mcpServers": {
    "s1000d-brex": {
      "command": "npx",
      "args": ["-y", "@shuji-bonji/s1000d-brex-mcp"],
      "env": {
        "S1000D_SPEC_DIR": "/path/to/s1000d/issue-7",
        "S1000D_CSDB_DIR": "/path/to/your/csdb"
      }
    }
  }
}

Once it is registered, try asking for things like these.

  • “From the default BREX, explain 20 rules that concern descript (descriptive data modules) in plain terms” → explain_brex
  • “Check this data module (path) against the BREX and list the violations” → check_against_brex
  • “What does 01 for securityClassification mean in this BREX?” → lookup_value
Section titled “What to read next”