s1000d-reader-mcp
Summary: An MCP server for reading S1000D CSDB content as structured data, resolving references, and evaluating applicability and verification for an LLM.
List data modules and other CSDB objects (PM, DML, DDN, IMF, UPF, ICN) with filters, paging, and selectable CSDB folders.
Read a data module as a structured body tree with identification/status, references, warnings, steps, figures, tables, size, security classification, and verification status.
Evaluate per-block applicability for a supplied product; optionally omit notApplicable blocks.
Describe applicability vocabulary from ACT/CCT/PCT and DM applic statements.
Read publication modules as a table of contents with resolved dmRef/pmRef targets.
Resolve DMC, PMC, or ICN references to CSDB files; for ICNs, include DOCTYPE/entity details.
Read ICN metadata files (IMF): ICN, issue, title, keywords, security, status items, and related ICN files.
Choose verification level: XSD only, full BREX/reference checks, or none.
Run over stdio or Streamable HTTP and configure via environment variables or a config file.
Parses and structures XML documents (S1000D data modules, publication modules and ICN metadata files) supplied by file path or as an XML string up to 5 MB, returning headings, steps, warnings, tables, illustrations and references as a tree instead of raw XML, and reporting a verification status based on XSD validation (optionally extended to BREX rule chains and reference resolution) plus DOCTYPE entity declarations for ICN references.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@s1000d-reader-mcp List all data modules related to the engine subsystems for this project."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@shuji-bonji/s1000d-reader-mcp
English | 日本語
An MCP server that lets an LLM read S1000D® data modules and publication modules as structure rather than as XML. It returns the heading hierarchy, numbered steps, warnings, cautions and notes, illustrations (ICN), tables and the titles of reference targets intact, and the server evaluates which product the content applies to (applicability) and passes on only the result. Every response carries how far the document has been verified (verification).
This is a personal project and is not affiliated with ASD (Aerospace, Security and Defence Industries Association of Europe). S1000D® is a registered trademark of ASD.
The S1000D specification, XML schemas, default BREX and official samples are not included in any package or repository, because their terms of use do not grant redistribution. Obtain them froms1000d.org and point the S1000D_SPEC_DIR environment variable at the extracted folder.
What it does
Tool | Description |
| Lists the data modules in a CSDB (and, on request, PMs, DMLs, DDNs, IMFs and UPFs) with their DMC, title, issue, language, schema name and applicability display text. Filters by model identification code, system code, information code, schema name and title text. A DML or DDN row also carries its code, issue date, entry or item count and a reconciliation summary against the CSDB ( |
| Reads one data module as structure: the identification and status section, the body tree (sections, paragraphs, lists, tables, illustrations, warnings, numbered steps and requirements, process branches, fault isolation questions and answers), references (with titles) and the verification status. Pass |
| Reads a publication module as a table of contents: the |
| Resolves a DMC, PMC or ICN to a file in the CSDB. For an ICN it also returns the DOCTYPE declaration of the referencing DM (file name and NOTATION) |
| Returns the applicability vocabulary: product attributes from the ACT (id, name, enumerations, identifiers), conditions from the CCT, products from the PCT (values that can be passed to |
| Reads an ICN metadata file (IMF): ICN, issue, title, keywords, security classification and a list of the items in the status section |
Reading applicability
State | Meaning |
| Applies to the product you passed |
| Does not apply. |
| Cannot be evaluated. |
The server does not return assert / evaluate expressions. Look up the attributes and values you need with describe_applicability and pass them to product in the form { "attributes": { "model": "…" }, "conditions": { … } }.
Verification status (verification)
By default the server runs XSD validation only (verify: "schema"). verify: "full" also checks against the BREX (Business Rules Exchange) chain and resolves references; verify: "none" skips them. A skipped step is reported as not-run, and a missing XSD as schema-not-found; neither is valid. In a document that violates the XSD, elements may be in positions that differ from the specification, so treat the reading of the body with suspicion as well.
Security classification (securityClassification) and size (size)
Every read_data_module and read_publication_module response starts with securityClassification: dataModule (the value in the identification and status section) and inContent (the number of body elements per value). The server does not interpret the values (S1000D leaves their meaning to the project). An agent can decide how to handle the content before quoting it. The body carries size (nodes, characters, count per kind, number of warnings) so the amount to read can be estimated.
Related MCP server: Synergy/DE MCP Server
What it does not do
It does not summarise or translate. Its job is to return the material a summary needs (headings, step numbers, warning types, reference targets) without dropping anything.
It does not judge conformance to S1000D. Read the details of XSD and BREX violations with
s1000d-verify-mcp, and the explanation of BREX rules withs1000d-brex-mcp.The body is structured for 5 types only:
descript/proced/process/fault/pm. Other types returncontent.structured: falseand only the identification and status section. Unknown elements are kept askind: "unknown"with their text only and counted incontent.unknownElements.
Configuration
Environment variable | Description |
| The folder where you extracted the S1000D distribution you obtained. The server looks for the XSD ( |
| The folder that holds the project's data modules. Several folders can be given, separated by |
Folders can also be given with the tool argument csdbDirs. When the argument is given, only those folders are used; S1000D_CSDB_DIR and csdbDirs in the config file are not used (they are not added together). Folders that do not exist are skipped and listed in _notes of the response. When none is left, the tool returns no-csdb (below).
Errors
An error that the caller can fix by changing an argument is not returned as a tool failure (isError) but in the same shape as s1000d-writer-mcp.
{ "error": { "code": "file-not-found", "path": "/path", "detail": "File not found: /path/to/DMC-….XML" } }
| Meaning |
| There is no file at the path given in the argument |
| No CSDB folder exists (pass |
| The DMC, PMC or ICN is not in the CSDB |
| An argument is malformed, or a required argument is missing |
path names the argument to fix (/path, /csdbDirs and so on), not a file path.
Config file (when environment variables are not passed, as with plugins in Claude Desktop)
If S1000D_SPEC_DIR / S1000D_CSDB_DIR are not set, the server reads the config file ~/.config/s1000d-stack/config.json (under XDG_CONFIG_HOME if it is set; S1000D_CONFIG changes the location). Claude Desktop does not pass environment variables to servers installed as plugins, and does not substitute ${VAR} written in the plugin's env. When you install the server as a plugin, write the folders here.
{
"specDir": "/path/to/s1000d/issue-7",
"csdbDirs": ["/path/to/your/csdb"]
}Environment variables take precedence when they are set. Paths that start with ~/ are accepted. The config file is read again on every call, so the server does not need to be restarted after you edit it.
Example configuration for Claude Desktop / Claude Code
{
"mcpServers": {
"s1000d-reader": {
"command": "npx",
"args": ["-y", "@shuji-bonji/s1000d-reader-mcp"],
"env": {
"S1000D_SPEC_DIR": "/path/to/s1000d/issue-7",
"S1000D_CSDB_DIR": "/path/to/your/csdb"
}
}
}
}Running over HTTP (embedding in a product)
The default is stdio. With --http the server starts over Streamable HTTP, so a CSDB product's server or a web application can call it over HTTP (the embedding foundation of stage 2.5).
npx -y @shuji-bonji/s1000d-reader-mcp --http # http://127.0.0.1:3000/mcp
npx -y @shuji-bonji/s1000d-reader-mcp --http --port 3101 --path /readerArgument | Default | Meaning |
|
| Address to bind to |
|
| Port; |
|
| Path of the MCP endpoint. |
| (see below) | Host names allowed in the |
| (see below) | Host names allowed in the |
When --host is a loopback address (127.0.0.1 / ::1 / localhost), Host and Origin are limited to localhost names (DNS rebinding protection). When bound to any other address they are not checked, so put the server behind the product's reverse proxy or authentication. Authentication, authorization and multi-tenancy are not part of this server. Environment variables and the config file work the same as with stdio.
How it works
All reading, evaluation and validation code lives in the shared library @shuji-bonji/s1000d-core; this server holds only the interpretation of arguments and the shape of the responses. The verification status is built with the same function as s1000d-verify-mcp, so the results of the two servers agree.
Development
npm install
npm test # runs on self-made test data only
npm run test:spec # uses the distribution you obtained (location given by S1000D_SPEC_DIR; default ../../specs/s1000d/issue-7)
npm run build && S1000D_SPEC_DIR=/path/to/issue-7 S1000D_CSDB_DIR=/path/to/csdb npm start # start over stdioLicense
MIT. S1000D® is a registered trademark of ASD. This software is not affiliated with ASD and does not include the specification, schemas or official samples.
Available Tools
6 toolsdescribe_applicabilityA
Describe the applicability vocabulary of a data module so a product can be chosen: the ACT product attributes (ids, names, enumerations/patterns, which one identifies the product), the CCT condition types and conditions, the PCT products (ready-made product values), the applic statements in the data module (ids and display texts), and which attributes used by the statements have no value in the PCT. Nothing is evaluated here; pass the chosen values as "product" to read_data_module.
Inputs: dmc, xml, path, csdbDirs.
list_data_modulesA
List the CSDB objects (data modules by default; optionally publication modules, DML, DDN, IMF, UPF) in the CSDB folders with DMC parts, techName/infoName, issue, language, schema name (descript/proced/…), S1000D issue and applicability display text. Filter by modelIdentCode, systemCode, infoCode, schemaName or title text. Paged with offset/limit.
Inputs: limit, filter, offset, include, +1 more.
read_data_moduleA
Read one data module as structure, not XML: identification and status (DMC, issue, language, title, BREX ref, QA, DM-level applicability), the body as a tree of blocks (sections, paragraphs, lists, tables, figures with ICN, warnings/cautions/notes, numbered steps, requirements; processes and fault isolation too), the references it makes, and ALWAYS a "verification" status (XSD by default). Applicability of each block is evaluated for the given product (applicable / notApplicable / undetermined); without a product, only display texts are returned — assert expressions are never returned.
Inputs: dmc, xml, path, verify, +5 more.
read_icn_metadataB
Read an ICN metadata file (IMF, icnmetadata.xsd): ICN, issue, title, keywords, security, source/originator and other status items as a flat list, plus the related ICN files found in the CSDB.
Inputs: icn, xml, path, csdbDirs.
read_publication_moduleB
Read a publication module (PMC) as a table of contents: the pmEntry tree with titles, and for each dmRef/pmRef the resolved target (file, techName/infoName, issue) from the CSDB. Also returns the PM identification and a verification status.
Inputs: pmc, xml, path, verify, +1 more.
resolve_referenceA
Resolve one reference to a CSDB object: a DMC, a PMC, or an ICN (file name or entity name). Returns the file path(s), issue(s) and title. For an ICN, pass "fromPath" of the data module whose DOCTYPE declares the entity to get the declared file and notation.
Inputs: dmc, icn, pmc, csdbDirs, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a clearly distinct operation: listing CSDB objects, reading a data module, reading a publication module, resolving a reference, reading ICN metadata, and describing applicability vocabulary. The overlap around ICNs is well separated by purpose (resolve location vs read metadata), and read_data_module vs read_publication_module concern different S1000D object types.
All names follow a consistent snake_case verb_noun pattern: list_data_modules, read_data_module, read_publication_module, resolve_reference, read_icn_metadata, describe_applicability. The repeated verbs are used predictably for operations on different object types.
Six tools is well-scoped for an S1000D CSDB reader: enough to list, read, resolve, inspect metadata, and understand applicability without bloating the surface. Each tool has a clear role in the workflow.
The set covers the core reader workflows for data modules, publication modules, references, ICN metadata, and applicability discovery. A minor gap is that list_data_modules can enumerate DML, DDN, IMF, and UPF objects, but there are no dedicated tools for reading DML/DDN/UPF content beyond listing.
Maintenance
Related MCP Connectors
The Needle MCP server enables semantic search on documents stored in files like PDFs, DOCX, and XLSX by connecting AI applications to external data sources. It provides capabilities to create and manage document collections, perform natural language searches on stored content, and retrieve relevant information without requiring exact keyword matches.
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Token-free MCP server for structured RevoGrid Core, Pro, and Enterprise knowledge retrieval.
Read-only MCP server over the developer docs for the portfolio's JSON API, MCP, A2A and NLWeb.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceThis server provides an API to query Large Language Models using context from local files, supporting various models and file types for context-aware responses.1ISC
- AlicenseAqualityCmaintenanceA read-only server that exposes Synergy/DE documentation as tools and resources for searching, retrieving, and browsing topics. It features full-text search, version support, and optimized content chunking for seamless integration with LLMs and MCP clients.5MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides document analysis capabilities to LLM applications, including extraction, chunking, summarization, and semantic search for PDF, DOCX, and plaintext documents.-
- AlicenseNot gradedqualityBmaintenanceThis MCP server provides semantic document search and retrieval, enabling AI assistants to search documents, search categories, and retrieve category hierarchies using the Model Context Protocol.2MIT