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

[dependencies]
anyrepair = "0.1.10"

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}

# 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

🏗️ 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

• 402+ test cases with 100% pass rate
• 99.6% improvement from regex caching
• Streaming support for files larger than RAM

See CHANGELOG.md for complete version history.

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
• ✅ 402+ tests, 100% pass rate

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")?;

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"}"#)?;

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)?;

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"))?;

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());

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.

# 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

• 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

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

See TEST_SUMMARY.md for details.

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 402+ tests covering real-world failures

• 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

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

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

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

Apache-2.0

https://github.com/yingkitw/anyrepair