<p align="center"> <img src="assets/logo.jpg" alt="clatcher logo" width="400"> </p>

ellmos-clatcher-mcp

🇩🇪 Deutsche Version

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.

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

Each server covers a different domain. Use one, two, or all three depending on your workflow.

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

122 tests covering all 12 tools (vitest).

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	43	Filesystem, process management, interactive sessions	ellmos-filecommander-mcp
CodeCommander	17	Code analysis, AST parsing, import management	ellmos-codecommander-mcp
Clatcher	12	File repair, format conversion, batch operations	ellmos-clatcher-mcp
n8n Manager	13	n8n workflow management via AI assistants	n8n-manager-mcp

AI Infrastructure

Project	Description
BACH	Text-based OS for LLMs — 109+ handlers, 373+ tools, 932+ skills
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 gelten die Haftungsausschlüsse aus GPL-3.0 / MIT / Apache-2.0 §§ 15–16 (je nach gewählter 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. Liability is limited to intent and gross negligence (§ 521 German Civil Code). Use at your own risk. No warranty, no maintenance guarantee, no fitness-for-purpose assumed.