Skip to content
MCP ThesaurusMCP Thesaurus

Ellmos Clatcher MCP

CommunityExcellent80/100Claim

npm ellmos-clatcher-mcpstdioMITupdated 11d ago

Claude Patcher -- an MCP server that extends AI coding agents with utility tools they don't have natively. File repair, format conversion, duplicate detection, batch operations, and more.

SourceWebsite1

What can you do with Ellmos Clatcher MCP?

ellmos-clatcher-mcp

🇩🇪 Deutsche Version | 🛡️ Security Policy | 📝 Changelog | 📋 llms.txt

npm version License: MIT Node.js Clatcher tests Vitest MCP Registry Ready Glama LLM-Ready Ecosystem Umbrella

Claude Patcher -- an MCP server that extends AI coding agents with utility tools they don't have natively. File repair, format conversion, duplicate detection, batch operations, and more.

Use Clatcher when your agent needs reliable local maintenance tools for text files, data files, and project folders: repair invalid JSON, normalize encodings, convert formats, compare folders, rename files safely, and verify checksums without leaving the MCP workflow.

[!NOTE] AI / LLM Integration Note: All destructive operations (e.g. batch_rename, cleanup_file, fix_json, fix_encoding, fix_umlauts) default to dry-run mode (dry_run: true). Autonomous agents must explicitly specify dry_run: false to execute mutations on disk.

System Architecture & Data Flow

graph TD
    Agent[AI Agent / Claude Code / Cursor / IDE] -->|MCP JSON-RPC Protocol over Stdio| Transport[MCP Stdio Transport Layer]
    Transport --> Server[Clatcher MCP Server Runtime]
    Server --> Dispatcher{Tool Dispatcher}

    Dispatcher -->|fix_json / cleanup_file| JsonEngine[JSON Linter & Auto-Fix Engine]
    Dispatcher -->|fix_encoding / fix_umlauts| EncodingEngine[Encoding Normalizer & Mojibake Resolver]
    Dispatcher -->|convert_format| FormatEngine[Format Converter: JSON/YAML/TOML/XML/CSV/INI]
    Dispatcher -->|detect_dupes / checksum| HashEngine[SHA-256 / Multi-Hash Content Engine]
    Dispatcher -->|folder_diff / batch_rename| FileOpsEngine[Folder Diff & Regex Batch Renamer]
    Dispatcher -->|archive / zip| ArchiveEngine[AdmZip Compression Handler]
    Dispatcher -->|scan_emoji / regex_test| RegexEngine[Emoji Scanner & Regex Debugger]

    JsonEngine --> DryRunGuard{Dry-Run Guard}
    EncodingEngine --> DryRunGuard
    FormatEngine --> DryRunGuard
    FileOpsEngine --> DryRunGuard
    ArchiveEngine --> DryRunGuard

    DryRunGuard -->|dry_run: true (default)| PreviewReport[Detailed Dry-Run Preview Diff & Status]
    DryRunGuard -->|dry_run: false (explicit)| DiskWrite[Safe Atomic Filesystem Write]

Part of the ellmos MCP family:

Server Focus npm
ellmos-filecommander-mcp Filesystem operations, process management, interactive sessions ellmos-filecommander-mcp
ellmos-codecommander-mcp Code analysis, AST parsing, import management ellmos-codecommander-mcp
ellmos-clatcher-mcp Utility tools: repair, convert, detect, batch ops ellmos-clatcher-mcp
n8n-manager-mcp n8n workflow management via AI assistants n8n-manager-mcp
ellmos-controlcenter-mcp MCP stack discovery, profile management, control plane ellmos-controlcenter-mcp
ellmos-homebase-mcp LLM memory, knowledge, state, routing, and orchestration ellmos-homebase-mcp (alpha)
ellmos-servercommander-mcp Server operations: deploy dry-runs, mail status, log analysis, health checks ellmos-servercommander-mcp (alpha)
ellmos-blender-use-mcp Headless Blender asset QA and FBX reimport verification ellmos-blender-use-mcp (alpha)
open-compute-mcp Model-agnostic computer use: capture, safety-gated actions, Windows UIA open-compute-mcp (alpha)

Each server covers a different domain. Use one server, a focused pair, or the full family depending on your workflow.

Discoverability

Primary search terms: ellmos-clatcher-mcp, clatcher mcp, claude patcher, mcp json repair server, mcp encoding fix, model context protocol file repair, claude code utility tools, format conversion mcp tool, duplicate file detection mcp, batch rename mcp, checksum mcp, zip archive mcp.

Tools

Tool Description
fix_json Repair broken JSON: strip comments, trailing commas, single quotes, BOM/NUL
fix_encoding Fix encoding issues: BOM removal, double-encoded UTF-8, cp1252 artifacts
fix_umlauts Fix broken German umlauts from double-encoding (e.g. ä -> ä)
convert_format Convert between JSON, YAML, TOML, XML, CSV, and INI
detect_dupes Find duplicate files by content hash (SHA256), grouped by identical content
folder_diff Compare two directories, or take a snapshot and diff on next call
batch_rename Rename files using regex patterns, with dry-run preview
archive Create, extract, or list ZIP archives
checksum Calculate file hashes (SHA256, MD5, SHA1, SHA512) with optional verification
cleanup_file Remove BOM, trailing whitespace, fix line endings, strip NUL bytes
scan_emoji Find emoji characters in code files
regex_test Test regex patterns against text, showing all matches with groups

All destructive tools default to dry-run mode and require explicit dry_run: false to write changes.

Installation

Claude Code CLI

claude mcp add ellmos-clatcher-mcp -- npx ellmos-clatcher-mcp

npm (global)

npm install -g ellmos-clatcher-mcp
claude mcp add ellmos-clatcher-mcp -- ellmos-clatcher

From source

git clone https://github.com/ellmos-ai/ellmos-clatcher-mcp.git
cd ellmos-clatcher-mcp
npm install
npm run build
node dist/index.js

Testing

npm test

146 tests covering all 12 tools, i18n language packs, repository hygiene, and metadata consistency (vitest). The GitHub Actions workflow runs npm ci, TypeScript build, Vitest, and an npm package dry-run on Node.js 20, 22, and 24.

Requirements

  • Node.js >= 20

License

MIT

ellmos-ai Ecosystem

This MCP server is part of the ellmos-ai ecosystem — AI infrastructure, MCP servers, and intelligent tools.

MCP Server Family

Server Tools Focus npm
FileCommander 47 Filesystem, process management, interactive sessions, cloud-lock-safe operations ellmos-filecommander-mcp
CodeCommander 22 Code analysis, JSON repair, imports, diffs, regex ellmos-codecommander-mcp
Clatcher 12 File repair, format conversion, batch operations ellmos-clatcher-mcp
n8n Manager 19 n8n workflow management via AI assistants n8n-manager-mcp
ControlCenter 20 MCP stack discovery, profile management, control plane ellmos-controlcenter-mcp
Homebase 45 Local-first LLM memory, knowledge, state, routing, swarm orchestration ellmos-homebase-mcp (alpha)
ServerCommander 8 Server operations: health checks, log analysis, deploy dry-runs, mail diagnostics ellmos-servercommander-mcp (alpha)
Blender Use 3 Headless Blender asset QA and FBX reimport verification ellmos-blender-use-mcp (alpha)
Open Compute 10 Model-agnostic computer use: capture, safety-gated actions, Windows UIA open-compute-mcp (alpha)

AI Infrastructure

Project Description
BACH Local-first text-based OS for LLM agents — 113+ handlers, 550+ tools, SQLite memory
open-compute Model-agnostic computer-use core powering Open Compute MCP
clutch Provider-neutral LLM orchestration with auto-routing and budget tracking
rinnsal Lightweight agent memory, connectors, and automation infrastructure
ellmos-stack Self-hosted AI research stack (Ollama + n8n + Rinnsal + KnowledgeDigest)
MarbleRun Autonomous agent chain framework for Claude Code
gardener Minimalist database-driven LLM OS prototype (4 functions, 1 table)
ellmos-tests Testing framework for LLM operating systems (7 dimensions)

Desktop Software & Sibling Ecosystem

Our partner organization open-bricks and sister suites bundle AI-native applications and developer tooling:

Repository Focus Status
file-bricks/ProFiler Multi-column PySide6 desktop file manager with smart workspaces Active
doc-bricks/DokuZen Document conversion, batch OCR, metadata sanitization Active
dev-bricks/safe-start-for-codex Secure workspace preflight and agent bootstrap gates Active
dev-bricks/automation-master Cross-agent automation orchestrator and policy enforcer Active
dev-bricks/DevCenter Central development cockpit and service manager Active
dev-bricks/CodeBox Sandboxed code execution and containerized worker environment Active

Haftung / Liability

Dieses Projekt ist eine unentgeltliche Open-Source-Schenkung im Sinne der §§ 516 ff. BGB. Die Haftung des Urhebers ist gemäß § 521 BGB auf Vorsatz und grobe Fahrlässigkeit beschränkt. Ergänzend gilt der Gewährleistungsausschluss der MIT-Lizenz.

Nutzung auf eigenes Risiko. Keine Wartungszusage, keine Verfügbarkeitsgarantie, keine Gewähr für Fehlerfreiheit oder Eignung für einen bestimmten Zweck.

This project is an unpaid open-source donation under German law. Liability is limited to intent and gross negligence (§ 521 German Civil Code). The MIT License warranty disclaimer applies.

Use at your own risk. No warranty, no maintenance guarantee, no availability guarantee, and no fitness-for-purpose assumed.