This utility MCP server provides JSON repair, encoding fixes, and data conversion workflows. It also supports handling duplicates, batch rename operations, and working with archives. The server is intended to streamline common file/data cleanup and transformation tasks.

🛠️ Key Features

JSON repair
Encoding fixes
Conversion
Duplicate handling
Batch rename
Archives

🚀 Use Cases

Repair malformed JSON inputs
Fix character encoding issues during import/export
Convert data between formats
Identify and address duplicate entries
Apply consistent naming to multiple files
Extract, pack, or manage archived assets

⚡ Developer Benefits

Standardizes routine JSON and encoding cleanup steps via MCP tooling
Automates repetitive conversion, deduplication, and batch rename processes
Includes archive-oriented support for file-based workflows

⚠️ Limitations

Feature set is limited to the listed utilities (JSON repair, encoding fixes, conversion, duplicates, batch rename, archives).

clatcher logo

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.

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

bash

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

npm (global)

bash

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

From source

bash

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

bash

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.

Ellmos Clatcher MCP

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

ellmos-clatcher-mcp

Discoverability

Tools

Installation

Claude Code CLI

npm (global)

From source

Testing

Requirements

License

ellmos-ai Ecosystem

MCP Server Family

AI Infrastructure

Desktop Software

Haftung / Liability

Install