ellmos-clatcher-mcp

🇩🇪 Deutsche Version

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

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.

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)

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

Discoverability

• npm: ellmos-clatcher-mcp
• GitHub: ellmos-ai/ellmos-clatcher-mcp
• MCP Registry metadata: server.json declares the official io.github.ellmos-ai/ellmos-clatcher-mcp package identity.
• LLM index: llms.txt summarizes the tool surface for agents and registry crawlers.

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

141 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 >= 18

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	46	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	18	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

Our partner organization open-bricks bundles AI-native desktop applications — a modern, open-source software suite built for the age of AI. Categories include file management, document tools, developer utilities, and more.

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.