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

On save: review.enforceTags.check - Block unknown tags
Auto-fix: review.fixIds.plan → review.fixIds.apply - Fix IDs
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

Deploy Server

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

ReviewMCP