# S1000D Writer (S1000D Stack)

> S1000D Writer (S1000D Stack) is a free MCP server for files and documents. Build and verify S1000D data modules from structured drafts without hand-writing XML. It runs locally on your machine and is started by your AI client.

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

## About

Technical publication authors using the S1000D standard can have an LLM draft content while the server handles the XML. The model passes a structured draft and numbering rules, and the server generates the data module, validates it against the XSD, the BREX business rules and cross-references, then applies only fixes that have exactly one candidate. Fixes with several candidates are returned for you to choose from, and a value outside the candidates is never accepted.

Nothing is written to disk unless you pass write: true, and then only into the first configured CSDB folder. Existing files are not overwritten and schema-invalid XML is refused unless you override it. DMC numbers, ICNs and issues come from a ledger, so the same sourceId always gets the same DMC.

The S1000D specification, schemas and default BREX are not bundled, so you must obtain them from s1000d.org and point S1000D_SPEC_DIR at them. The author says this is a personal project not affiliated with ASD.

## Features

- **Draft to data module:** Builds descript, proced, process, fault or PM modules from one structured draft.
- **Layered verification:** Checks XSD, BREX rules and references after each build.
- **Exact-only auto fixes:** Applies a fix only when there is a single candidate, up to a set number of rounds.
- **Manual conversion:** Converts an experiential manual into one data module per topic plus a publication module.
- **Translation round trip:** Extracts sentences with placeholders, then puts translations back with a skeleton hash check.
- **Safe writes:** Writes nothing by default and refuses overwrites and invalid XML unless told otherwise.

## Good for

- Generate S1000D procedures from drafted steps
- Convert an experiential manual into data modules
- Prepare data module text for translation
- Add comment data modules to a CSDB

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `build_data_module`: Builds a data module from one draft and numbering rules, verifies XSD, BREX and references, and applies only exact fixes.
- `convert_manual`: Converts an experiential manual into one data module per topic plus a publication module.
- `apply_fixes`: Applies fixes you selected from the candidates and re-verifies.
- `create_comment`: Builds a comment data module and verifies it.
- `extract_segments`: Extracts human-readable sentences from a data module for translation with placeholders.
- `apply_segments`: Puts translated sentences back into the data module they came from.

## FAQ

### Does it include the S1000D spec?

No. Terms of use do not allow redistribution, so you download it from s1000d.org and set S1000D_SPEC_DIR.

### Will it write files automatically?

No. It writes only when write is true and a CSDB directory is available.

### Is it officially affiliated with S1000D?

No. The author says it is a personal project not affiliated with ASD.

### How are DMC numbers assigned?

From a ledger and the CSDB, so the same sourceId always gets the same DMC.

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

Yes. S1000D Writer (S1000D Stack) is free to use.

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

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

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

The closest alternatives to S1000D Writer (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-writer-s1000d-stack
