# S1000D Reader (S1000D Stack)

> S1000D Reader (S1000D Stack) is an open-source MCP server for developer tools. MCP server that reads S1000D data and publication modules as structure with applicability. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://shuji-bonji.github.io/s1000d-stack/
- **Repository:** https://github.com/shuji-bonji/s1000d-reader-mcp
- **MCP Registry name:** io.github.shuji-bonji/s1000d-reader-mcp
- **Categories:** developer tools, files and documents
- **Listing updated:** 2026-11-14

## About

Raw S1000D XML is awkward for a model, so this server hands back the document as a tree: heading hierarchy, numbered steps, warnings, cautions, notes, illustrations (ICN), tables and the titles of reference targets. A publication module comes back as a table of contents with each dmRef and pmRef resolved to a file, title and issue.

Its main idea is applicability. Pass a product and each block is marked applicable, notApplicable or undetermined, where undetermined carries a reason and does not mean the block is irrelevant; omitNotApplicable can drop the irrelevant blocks. A describe_applicability tool lists the attributes, conditions and products defined in the ACT, CCT and PCT, and evaluates nothing. Every response includes a verification field, running XSD validation by default or the full BREX chain when asked.

For large modules, an outline mode returns headings, step numbers and subtree sizes so the document can be surveyed first. The S1000D specification and schemas are not bundled; set S1000D_SPEC_DIR to a copy from s1000d.org. It is a personal project, not affiliated with ASD.

## Features

- **Structured module reading:** Returns headings, steps, warnings, tables and illustrations as a tree.
- **Applicability filtering:** Marks blocks applicable, notApplicable or undetermined for a given product.
- **Outline mode:** Surveys a large data module before reading its body.
- **Reference resolution:** Resolves a DMC, PMC or ICN to a file in the CSDB.
- **Image metadata:** Reads ICN metadata files including keywords and security classification.
- **Verification status:** Each response says how far the document was verified.

## Good for

- Summarise a maintenance procedure without parsing XML
- List data modules in a CSDB by system or information code
- Show only the steps that apply to one product variant
- Resolve the file behind an illustration reference

## Install

### Claude Code (Terminal)

```sh
claude mcp add s1000d-reader-mcp -- npx -y @shuji-bonji/s1000d-reader-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "s1000d-reader-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/s1000d-reader-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "s1000d-reader-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/s1000d-reader-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "s1000d-reader-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/s1000d-reader-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "s1000d-reader-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/s1000d-reader-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "s1000d-reader-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/s1000d-reader-mcp"
      ]
    }
  }
}
```

## Tools

- `list_data_modules`: Lists data modules in a CSDB with DMC, title, issue, language, schema and applicability text
- `read_data_module`: Reads one data module as structure, optionally marking applicability for a product
- `read_publication_module`: Reads a publication module as a table of contents
- `resolve_reference`: Resolves a DMC, PMC or ICN to a file in the CSDB
- `describe_applicability`: Returns the applicability vocabulary from the ACT, CCT and PCT
- `read_icn_metadata`: Reads an ICN metadata file

## FAQ

### What does undetermined mean?

The server could not evaluate applicability, for example because the product lacks an attribute. It is not the same as not applicable.

### How is verification handled?

By default XSD validation runs; verify full also checks the BREX chain.

### Is the S1000D specification included?

No. Get it from s1000d.org and set S1000D_SPEC_DIR.

### Does it edit data modules?

The README describes only reading tools.

### Is S1000D Reader (S1000D Stack) free?

Yes. S1000D Reader (S1000D Stack) is open source, so you can use and self-host it for free.

### How do I add S1000D Reader (S1000D Stack) to Claude Code?

Run this command in your terminal: claude mcp add s1000d-reader-mcp -- npx -y @shuji-bonji/s1000d-reader-mcp

### What are the best alternatives to S1000D Reader (S1000D Stack)?

The closest alternatives to S1000D Reader (S1000D Stack) are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/s1000d-reader-s1000d-stack
