Skip to main content
Glama
dsgarage

ReviewMCP

by dsgarage
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

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

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dsgarage/ReviewMCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server