review-mcp-min

Minimal MCP (Model Context Protocol) server for Re:VIEW document processing with JS/Ruby hybrid pipeline.

Version

v0.1.0 - Initial release with hybrid pipeline support

Features

Core Functionality

• Tag Enforcement: Validates Re:VIEW markup tags against configurable allowlists

• ID Management: Automatically fixes empty/duplicate IDs in blocks and captions

• Fast Linting: Quick sanity checks via LaTeX compilation

• Hybrid Pipeline: JS preprocessing + Ruby (LaTeX Builder) for PDF generation

Security (SSOT - Single Source of Truth)

• Dynamic security configuration loading from ReviewExtention

• Two-layer defense: MCP pre-sanitization + Ruby final validation

• Path traversal and absolute path blocking for mapfile macros

• File size and extension validation

MCP Commands

Basic Commands

• review.version - Get Re:VIEW CLI version

• review.tags.list - List allowed tags

• review.enforceTags.check - Check for unknown tags

• review.fixIds.plan - Plan ID fixes for empty/duplicate IDs

• review.fixIds.apply - Apply ID fixes with backup

• review.lint - Run fast lint checks

Hybrid Pipeline Commands

• review.preprocess - JS preprocessing (currently passthrough)

• review.build-pdf-hybrid - Build PDF with hybrid pipeline

• review.check-ruby-extensions - Verify Ruby extensions

• review.test-mapfile - Test mapfile with security validation

Security Commands

• review.security.config - Get current security configuration

• review.security.validate-mapfile - Validate mapfile paths

• review.security.compare - Compare configs for SSOT compliance

Installation

# Clone the repository
git clone https://github.com/dsgarage/ReviewMCP.git
cd review-mcp-min

# Install dependencies
npm install

# Build TypeScript
npm run build

# Start MCP server
npm start

Usage

Project Root (cwd) Specification

All MCP tools require a cwd parameter pointing to your Re:VIEW project root:

mybook/              ← This is cwd
├── config.yml       ← Required
├── catalog.yml      ← Required
├── ch01.re
├── ch02.re
├── images/
└── ...

The cwd must be the directory containing config.yml and catalog.yml.

With Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "review-mcp": {
      "command": "node",
      "args": [
        "/path/to/review-mcp-min/node_modules/.bin/tsx",
        "/path/to/review-mcp-min/src/index.ts"
      ]
    }
  }
}

With ClaudeCode

cd ~/books/mybook
claude mcp add review-mcp -s project -- \
  node ./tools/review-mcp/node_modules/.bin/tsx ./src/index.ts

Project Structure

review-mcp-min/
├── src/
│   ├── index.ts                 # MCP server main
│   ├── commands/
│   │   └── hybrid-pipeline.ts   # Hybrid pipeline commands
│   ├── config/
│   │   └── security.ts          # SSOT security configuration
│   └── utils/
│       └── runCommand.ts        # Command execution utilities
├── articles/                    # Re:VIEW test documents
│   ├── chapter01.re
│   └── chapter02.re
├── config.yml                   # Re:VIEW configuration
├── catalog.yml                  # Re:VIEW catalog
└── test-build.js               # Test script for hybrid pipeline

Development

# Run in development mode
npm run dev

# Type checking
npm run typecheck

# Build
npm run build

# Test PDF generation
node test-build.js

Testing

The repository includes test Re:VIEW documents demonstrating various features:

• Inline tags (strong, em, code, tt, kw)

• Block tags (list, emlist, note, memo, cmd, quote)

• Tables, source code blocks, footnotes

• Security and SSOT configuration examples

Run the test build:

review-pdfmaker config.yml

CI/CD

GitHub Actions workflow included (.github/workflows/mcp-hybrid.yml) for:

• Multi-version testing (Node.js 18/20, Ruby 3.x)

• Security configuration validation

• PDF generation testing

• SSOT compliance checking

Requirements

• Node.js 18+

• Ruby + Bundler

• Re:VIEW gem (5.x recommended)

• TeX Live (for PDF generation with uplatex)

Recommended Workflow

1. On save: review.enforceTags.check - Block unknown tags

2. Auto-fix: review.fixIds.plan → review.fixIds.apply - Fix IDs

3. Lint: review.lint - Show warnings

Configuration

Optional review-mcp.json:

{
  "profile": "dual",
  "target": "latex",
  "blockOnUnknownTags": true,
  "autoFixIdsOnSave": true
}

License

MIT

Contributing

Issues and PRs welcome at GitHub repository

Related Issues

• #5 - Ruby implementation integration

• #6 - Hybrid pipeline commands

• #7 - SSOT security configuration

Author

@dsgarage

Changelog

v0.1.0 (2025-01-08)

• Initial release

• Hybrid JS/Ruby pipeline implementation

• SSOT security configuration

• Basic Re:VIEW tag validation and ID management

• Test documents and PDF generation support