
Ellmos Clatcher MCP
io.github.ellmos-ai由 GitHub 帳號 ellmos-ai 發布v1.0.17更新於 Oct 26, 2026
Utility MCP server: JSON repair, encoding fixes, conversion, duplicates, batch rename, archives.
概覽
本機 MCP 伺服器,為編碼助理提供修復 JSON、修正編碼、格式轉換、重複檔案偵測、批次重新命名與 ZIP 壓縮檔等實用工具。
- 可以做什麼
- 修復與清理文字檔:修復損壞的 JSON、移除 BOM 與 NUL 位元組、統一換行字元、修正雙重編碼的德文變母音與 cp1252 亂碼
- 在 JSON、YAML、TOML、XML、CSV 與 INI 之間轉換結構化資料
- 檢查資料夾:依 SHA-256 雜湊找出重複檔案、比較兩個目錄或與快照比對、計算 SHA-256/SHA-512/MD5/SHA-1 校驗碼
- 以正規表示式批次重新命名檔案,並建立、解壓縮或列出 ZIP 壓縮檔
- 用文字測試正規表示式,並掃描程式碼檔案中的 emoji 字元
- 適用情境
- 當助理在本機專案資料夾中工作、經常遇到損壞的 JSON、編碼亂碼或格式不符時適用;也適合在 MCP 流程內完成可預覽的批次重新命名、重複檔案偵測與校驗碼驗證,而不必臨時拼湊命令列工具。
- 執行需求
- 以 npm 套件形式透過 stdio 在本機執行(npx 或全域安裝);需要 Node.js 20 或更新版本。未宣告需要帳號、API 金鑰或網路存取。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Ellmos Clatcher MCP,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
ellmos-clatcher-mcp
🇩🇪 Deutsche Version | 🇪🇸 Versión en español | 🤝 Contributing | 🛡️ Security Policy | 📜 Licenses | 📝 Changelog | 📋 llms.txt
[npm version] [License: MIT] [Node.js] [Platform] [Clatcher tests] [Vitest] [Security Policy] [Zero-Egress] [RunAsInvoker] [Attribution: NOTICE] [Third-Party Licenses] [Contributing Guidelines] [Marketing Log] [Verified: 2026-10-08] [Last Checked] [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 specifydry_run: falseto execute mutations on disk.
Highlights & Value Proposition
- 12 Specialized Agent Tools: Extends Claude Code, Cursor, and MCP agents with utilities they lack out-of-the-box (JSON repair, encoding normalization, format conversion, diffing, deduplication, regex batch renaming).
- Default Dry-Run Guard: Mutating tools run in preview mode (
dry_run: true) by default. Agents must passdry_run: falseto write to disk. - 100% Local-First & Zero-Egress: Pure local execution over stdio JSON-RPC. No network calls, no cloud telemetry, zero remote attack surface.
- Atomic File Operations: All disk modifications write to temporary staging buffers before replacement, preventing corrupt or truncated files.
- Lossless Encoding Preservation: Eliminates Windows cp1252 artifacts, BOM headers, and German umlaut Mojibake (
ä, ö, ü, ß) while guaranteeing pristine UTF-8 bytes. - Universal Multi-OS Parity: Tested continuously across Ubuntu, Windows, and macOS with native path handling and line endings.
🧭 Quick Navigation
Target Personas & Discoverability
Comparative Matrix & Alternatives
System Architecture & Data Flow
ASCII Four-View Architectural Topology
Component Data Flow Diagram
End-to-End Execution Sequence
Core Invariants & Safety Guarantees
Tools
All destructive tools default to dry-run mode and require explicit dry_run: false to write changes.
Installation
Claude Code CLI
Claude Desktop / Cursor Configuration
Add Clatcher to your claude_desktop_config.json or Cursor MCP settings:
npm (global)
From source
Practical Usage Workflows
Clatcher provides deterministic, single-step utility actions tailored for AI coding workflows:
1. JSON Auto-Repair (fix_json)
Autonomous agent runs often stumble upon configuration files with trailing commas, single-quoted keys, or inline JavaScript comments:
Result: Comments and trailing commas are parsed and stripped, producing strict, spec-compliant JSON with verifiable bytes written.
2. Lossless Character Encoding Normalization (fix_encoding / fix_umlauts)
Fixes Windows cp1252 artifacts, BOM headers, and double-encoded UTF-8 sequences without data loss:
Result: Corrupted sequences like ä, ö, ü, à are converted back to clean UTF-8 ä, ö, ü, ß.
3. Multi-Format Configuration Conversion (convert_format)
Converts structured data between JSON, YAML, TOML, XML, CSV, and INI in a single pass:
4. Duplicate Detection & Cryptographic Hashing (detect_dupes / checksum)
Scans target directory trees to identify identical content using SHA-256 hash clustering without transmitting data over the network:
5. Safe Regex Batch Renaming (batch_rename)
Preview and stage batch file renames with regex patterns:
Dry-Run Protocol & Safety Verification
All mutating tools in ellmos-clatcher-mcp enforce a preview-first contract (dry_run: true by default):
- Safety Preview: Invoking
fix_json,cleanup_file,batch_rename,fix_encoding, orarchivewithout arguments returns a detailed unified diff and mutation preview without touching the disk. - Explicit Opt-In: Filesystem writes occur only when the agent explicitly supplies
dry_run: false. - Fail-Closed Argument Validation: Path parameters are strictly sanitized against path traversal (
..escapes) and bounded by project directory constraints. - Receipt Generation: Every modifying run produces an authoritative JSON receipt detailing bytes read, bytes written, and cryptographic verification status.
Encoding, Mojibake & Format Conversion
Clatcher incorporates specialized string manipulation primitives to resolve cross-platform text corruption:
- BOM Stripping: Automatically removes UTF-8 BOM headers (
0xEF, 0xBB, 0xBF) that break legacy CLI parsers and CI linters. - Mojibake Resolution: Reconstructs corrupted multi-byte sequences resulting from ISO-8859-1 or Windows-1252 interpretations of UTF-8 text.
- Line Ending Standardization: Converts mixed Windows CRLF (
\r\n) and Unix LF (\n) files into consistent line feeds. - NUL-Byte Removal: Sanitizes accidental binary NUL characters injected by interrupted network streams or corrupted disk blocks.
Multi-OS Support & Windows Path Robustness
Cross-platform parity is verified continuously on Linux, macOS, and Windows:
- Path Normalization: Resolves backslashes (
\) and forward slashes (/) transparently using native Node.jspathmodules. - Long Path Support: Safely operates on Windows deep nested structures without MAX_PATH (260 character) truncation.
- Unprivileged Execution: Operates under standard user rights (
RunAsInvoker), requiring no administrative elevation or root access.
ellmos MCP Family & Sibling Matrix
Part of the ellmos MCP family:
Each server covers a different domain. Use one server, a focused pair, or the full family depending on your workflow.
ellmos-ai Ecosystem
This MCP server is part of the ellmos-ai ecosystem — AI infrastructure, MCP servers, and intelligent tools.
AI Infrastructure
Desktop Software & Sibling Ecosystem
Our partner organization open-bricks and sister suites bundle AI-native applications and developer tooling:
Security Policy
For security vulnerability disclosure channels, supported versions, and our 48-hour response SLA, refer to SECURITY.md. For development guidelines, quality gates, and invariant contracts, see CONTRIBUTING.md.
Machine-Readable Context (llms.txt)
This repository provides a standardized machine-readable context file for AI agents, crawlers, and RAG indexers:
- llms.txt: Concise manifest of all 12 tools, dry-run safety invariants, sibling MCP tool counts, and CLI invocation examples.
Testing
178 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
Third-Party Licenses & Transparency
ellmos-clatcher-mcp adheres strictly to open-bricks and ellmos-ai open-source governance standards. All 7 direct runtime dependencies and 5 development dependencies are 100% permissively licensed (MIT, BSD-3-Clause, BSD-2-Clause, Apache-2.0) with zero copyleft (0% GPL/AGPL) and zero cloud telemetry.
Formal copyright notice and ecosystem attribution are codified in NOTICE. For the comprehensive dependency inventory, SPDX identifiers, Level 1 SBOM cross-reference matrix, and full license texts, see THIRD_PARTY_LICENSES.md and the plain-text companion THIRD_PARTY_LICENSES.txt.
Discoverability
- npm:
ellmos-clatcher-mcp - GitHub:
ellmos-ai/ellmos-clatcher-mcp - MCP Registry metadata:
server.jsondeclares the officialio.github.ellmos-ai/ellmos-clatcher-mcppackage identity. - Glama.ai Registry:
glama.jsonmanifest for Glama MCP ecosystem. - LLM index:
llms.txtsummarizes 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.
Changelog
For the complete release evolution, version notes, and hygiene audits, see CHANGELOG.md.
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.
來源:README.md,提交 7cd32f4
工具
0版本歷史
2- v1.0.17最新Oct 26, 2026
- v1.0.10Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分