AnyRepair

A Rust crate for repairing malformed structured data across multiple formats (JSON, YAML, Markdown, XML, TOML, CSV, INI, Diff).

Quick Start

Installation

[dependencies]
anyrepair = "0.2.1"

Basic Usage

use anyrepair::repair;

// Auto-detect format and repair
let malformed = r#"{"name": "John", age: 30,}"#;
let repaired = repair(malformed)?;
println!("{}", repaired); // {"name": "John", "age": 30}

CLI

# Install
cargo install anyrepair

# Auto-detect and repair
anyrepair repair input.json

# Format-specific repair
anyrepair repair input.json --format json
anyrepair repair input.yaml --format yaml
anyrepair repair input.md --format markdown

# Show confidence score
anyrepair repair input.json --format json --confidence

# Batch process multiple files
anyrepair batch --input ./data --output ./repaired --recursive

# Stream large files
anyrepair stream --input large_file.json --output repaired.json --format json

# Validation without repair
anyrepair validate --input input.json --format json

# Custom rules management
anyrepair rules list

# Show supported formats
anyrepair stats

What's New

v0.2.1 - Latest Release

🏗️ KISS/DRY/SoC Refactoring

Centralized format registry: single source of truth for format→repairer/validator mapping
Unified CLI: repair --format <fmt> replaces 8 per-format subcommands
Extracted format_detection module for clean separation of concerns
Removed dead code (BaseRepairer trait, standalone apply_strategies)
~400 lines of duplicated code eliminated

🔧 8 Format Support

JSON, YAML, Markdown, XML, TOML, CSV, INI, Diff/Unified Diff
Auto-detection from malformed content
Format-specific validation and repair strategies

🐍 Python-Compatible API

Drop-in compatible with Python's jsonrepair library
jsonrepair() function and JsonRepair class API

🔌 MCP Server Integration

Native Claude Desktop integration via MCP
10 MCP tools for all 8 formats plus auto-detect and validate

⚡ Performance & Quality

280+ test cases with 100% pass rate
99.6% improvement from regex caching
Streaming support for files larger than RAM
Zero compilation warnings

See CHANGELOG.md for complete version history.

Why AnyRepair?

Structured data from LLMs, APIs, or manual editing is often malformed. AnyRepair fixes common issues:

JSON: Missing quotes, trailing commas, syntax errors
YAML: Indentation issues, missing colons
Markdown: Malformed headers, broken links
XML/TOML/CSV/INI/Diff: Format-specific repairs

Key Features:

✅ Auto-detects format from damaged content
✅ Multi-format support (8 formats)
✅ High performance (regex caching, optimized binaries)
✅ MCP server for Claude integration
✅ Streaming support for large files
✅ 280+ tests, 100% pass rate

Usage Examples

Multi-Format Auto-Detection

use anyrepair::repair;

// JSON - auto-detected and repaired
let json = repair(r#"{"key": value,}"#)?;
// Output: {"key": "value"}

// YAML - auto-detected and repaired
let yaml = repair("name: John\nage: 30")?;

// Markdown - auto-detected and repaired
let markdown = repair("# Header\n[link](url")?;

// Diff - auto-detected and repaired
let diff = repair("@@ -1,3 +1,4 @@\n-line 1\n+line 1 modified")?;

Python-Compatible JSON API

use anyrepair::{jsonrepair, JsonRepair};

// Function-based API (like Python's jsonrepair)
let repaired = jsonrepair(r#"{"name": "John", age: 30,}"#)?;

// Class-based API (like Python's JsonRepair class)
let mut jr = JsonRepair::new();
let repaired1 = jr.jsonrepair(r#"{"key": "value",}"#)?;
let repaired2 = jr.jsonrepair(r#"{name: "John"}"#)?;

Format-Specific Repairers

use anyrepair::{create_repairer, repair_with_format, traits::Repair};

// Via registry (recommended)
let mut repairer = create_repairer("json")?;
let repaired = repairer.repair(malformed_json)?;
let confidence = repairer.confidence(&repaired);

// Shorthand
let repaired = repair_with_format(malformed_yaml, "yaml")?;

// Direct struct usage still works
use anyrepair::json::JsonRepairer;
let mut json_repairer = JsonRepairer::new();
let repaired = json_repairer.repair(malformed_json)?;

Streaming Large Files

use anyrepair::StreamingRepair;
use std::fs::File;
use std::io::BufReader;

let input = BufReader::new(File::open("large_file.json")?);
let mut output = File::create("repaired.json")?;

// Configure buffer size (default 8192 bytes)
let processor = StreamingRepair::with_buffer_size(65536);

// Process with automatic format detection
processor.process(input, &mut output, None)?;

// Or specify format explicitly
processor.process(input, &mut output, Some("json"))?;

Batch Processing

use anyrepair::BatchProcessor;

let processor = BatchProcessor::new();

// Process directory with options
let results = processor.process_directory(
    "./data",
    true,  // recursive
    "*.json",  // file filter
)?;

// Get per-file results
for result in results {
    println!("{}: {:?} ({}ms)",
        result.file_path,
        result.status,
        result.repair_time_ms
    );
}

// Get analytics
let analytics = processor.get_analytics();
println!("Success rate: {}%", analytics.success_rate());

MCP Server Integration

The MCP server provides seamless integration with Claude Desktop:

# Install and run MCP server
cargo install anyrepair
anyrepair-mcp

Configure in claude_desktop_config.json:

{
  "mcpServers": {
    "anyrepair": {
      "command": "anyrepair-mcp"
    }
  }
}

Available MCP Tools:

repair - Auto-detect and repair any format
repair_json, repair_yaml, repair_markdown, repair_xml
repair_toml, repair_csv, repair_ini, repair_diff
validate - Validate content without repair

Usage in Claude:

Please repair this JSON: {"name": "John", age: 30,}
(Claude will use the anyrepair MCP tool to fix it)

See MCP_SERVER.md for complete documentation.

Supported Formats

Format	Common Issues Fixed
JSON	Missing quotes, trailing commas, malformed numbers, boolean/null values
YAML	Indentation, missing colons, list formatting, document separators
Markdown	Headers, code blocks, lists, tables, links, images
XML	Unclosed tags, malformed attributes, missing quotes, entity encoding
TOML	Missing quotes, malformed arrays, table headers, dates
CSV	Unquoted strings, malformed quotes, extra/missing commas
INI	Malformed sections, missing equals signs, unquoted values
Diff	Missing hunk headers, incorrect line prefixes, malformed ranges

Advanced Features

Custom Rules

# Add custom repair rule via CLI
anyrepair rules add --id "fix_undefined" --format "json" \
  --pattern "undefined" --replacement "null" --priority 90

# List all rules
anyrepair rules list

# Enable/disable rules
anyrepair rules enable "fix_undefined"
anyrepair rules disable "fix_undefined"

# Remove a rule
anyrepair rules remove "fix_undefined"

Configuration file (anyrepair.toml):

# Custom rules configuration
[[rules]]
id = "fix_trailing_comma"
format = "json"
pattern = ",\\s*}"
replacement = "}"
priority = 95

[[rules]]
id = "fix_js_comments"
format = "json"
pattern = "//.*\\n"
replacement = ""
priority = 80

Performance

Regex Caching: 99.6% performance improvement over uncached operations
Optimized Binaries: 1.5 MB release builds (94% size reduction)
Streaming: Process files larger than available RAM using configurable buffers
Lazy Evaluation: Skip unnecessary strategies for faster repairs

Build Profiles:

# Standard release (size-optimized)
cargo build --release

# Distribution profile (maximum optimization)
cargo build --profile dist

Testing

280+ test cases with 100% pass rate
- 190 library tests (incl. 73 MCP server tests)
- 35 diff tests
- 26 streaming tests
- 18 complex damage tests
- 18 complex streaming tests
- 36 fuzz tests
- 18 damage scenarios
- 17 integration tests
- 15 CLI tests
- 2 doctests
Fuzz testing using proptest for robustness
Integration tests for end-to-end workflows

See TEST_SUMMARY.md for details.

Comparison

Feature	AnyRepair	json-repair-rs	json5	Python jsonrepair
Multi-format	✅ 8 formats	❌ JSON only	❌ JSON only	❌ JSON only
Auto-detection	✅ Smart detection	❌	❌	❌
MCP integration	✅ Native	❌	❌	❌
Streaming	✅ Large file support	❌	❌	❌
Custom rules	✅ CLI + API	❌	❌	❌
Python API	✅ Compatible	❌	❌	✅ Native
Language	Rust	Rust	Rust	Python
Binary size	1.5 MB	~500 KB	~200 KB	N/A

Why AnyRepair?

Most comprehensive format support (8 formats vs JSON-only alternatives)
Only Rust crate with Python-compatible API and MCP integration
Battle-tested with 280+ tests covering real-world failures
Zero compilation warnings

Documentation

ARCHITECTURE.md - System design and architecture
MCP_SERVER.md - MCP server integration guide
TEST_SUMMARY.md - Test coverage details
CHANGELOG.md - Version history and changes
INDEX.md - Complete documentation index
STREAMING_FEATURE.md - Streaming support details
BUILD_OPTIMIZATION.md - Build optimization guide

Quick Links

Report Issues: GitHub Issues
Contributing: See CONTRIBUTING.md (if available)
Changelog: CHANGELOG.md
API Docs: docs.rs

Examples

See the examples/ directory for:

mcp_repair_json.rs - MCP JSON repair usage
mcp_multi_format.rs - Multi-format MCP repair
mcp_server_usage.rs - MCP server setup and usage

Run examples:

cargo run --example mcp_repair_json

Roadmap

See TODO.md for planned features and improvement areas. Highlights include:

Additional format support (Properties, .env, Protobuf)
CLI enhancements (diff preview, dry-run, colored output)
Web interface and REST API
Language bindings (Python, Node.js, Go)
Format-preserving repairs, repair explanations

License

Apache-2.0

Repository

⭐ If you find AnyRepair useful, please consider starring the repo on GitHub! It helps others discover the project and motivates continued development.

💬 Feedback welcome! Share your experience, suggestions, or report issues via GitHub Issues, or leave a review on crates.io.

https://github.com/yingkitw/anyrepair

anyrepair 0.2.2