MCP 服务器

ellmos-clatcher-mcp

Utility-first MCP server that extends Claude Code with file-maintenance capabilities beyond built-in tools. Supports encoding repair, format conversion, duplicate detection, batch renaming, and archive utilities.

README

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.