Ellmos Clatcher MCP

ellmos-clatcher-mcp

🇩🇪 德语版 | 🤝 参与贡献 | 🛡️ 安全政策 | 📜 许可证 | 📝 更新日志 | 📋 llms.txt

Claude Patcher —— 一个 MCP 服务，为 AI 编码 Agent 提供原生不具备的实用工具。包括文件修复、格式转换、重复项检测、批量操作等。

当 Agent 需要可靠的本地维护工具来处理文本文件、数据文件和项目文件夹时，请使用 Clatcher：修复无效 JSON、规范化编码、转换格式、比较文件夹、安全重命名文件，并验证校验和，所有操作均可在 MCP 工作流中完成。

说明

AI / LLM 集成说明： 所有破坏性操作（例如 batch_rename、cleanup_file、fix_json、fix_encoding、fix_umlauts）默认采用试运行模式（dry_run: true）。自主 Agent 必须明确指定 dry_run: false 才会在磁盘上执行更改。

亮点与价值主张

• 12 个专用 Agent 工具：为 Claude Code、Cursor 和 MCP Agent 扩展开箱即用功能之外的实用工具（JSON 修复、编码规范化、格式转换、差异比较、去重、正则批量重命名）。
• 默认启用试运行保护：可修改数据的工具默认以预览模式运行（dry_run: true）。Agent 必须传入 dry_run: false 才能写入磁盘。
• 100% 本地优先且零外传：通过 stdio JSON-RPC 完全在本地执行。不进行网络调用、不收集云端遥测数据，远程攻击面为零。
• 原子文件操作：所有磁盘修改都会先写入临时暂存缓冲区，再进行替换，避免文件损坏或被截断。
• 无损保留编码：消除 Windows cp1252 痕迹、BOM 标头和德语变音符号乱码（ä, ö, ü, ß），同时保证 UTF-8 字节内容完好无损。
• 跨操作系统一致支持：持续在 Ubuntu、Windows 和 macOS 上测试，并原生处理路径和换行符。

🧭 快速导航

#	章节	重点
01	✨ 亮点与价值主张	12 个 AI Agent 原生功能中缺少的必备工具：修复、转换、去重、差异比较、批处理
02	🎯 目标用户与发现机制	自主 Agent、全栈开发者、发布工程师和安全合规
03	⚖️ 对比矩阵与替代方案	从 10 个维度对比标准 Agent shell、临时编写的 jq/sed 命令、桌面应用和云端 API
04	📐 系统架构与数据流	展示 stdio 传输和修复引擎的 5 层架构流程图
05	🔄 端到端执行顺序	从用户提示词到经验证的磁盘写入，共 14 步的试运行安全时序图
06	🛡️ 核心不变量与安全保障	10 项架构保证，确保默认试运行、零外传和原子写入
07	🛠️ 工具范围与功能	深入介绍全部 12 个 MCP 工具，包括参数架构和默认预览模式
08	⚙️ 安装与客户端设置	为 Claude Code CLI、Claude Desktop、Cursor 和 npm 全局安装提供简便设置流程
09	💡 实用工作流	Agent 修复操作指南：修复 JSON、规范化编码、批量重命名
10	🛡️ 试运行协议与安全验证	先预览再验证的机制，以及默认拒绝的磁盘写入控制
11	🔤 编码、乱码与格式转换	无损 UTF-8 规范化、去除 BOM、处理德语变音符号以及格式转换
12	💻 多操作系统支持与 Windows 路径可靠性	在 Windows CRLF、Linux LF 和 macOS 运行时之间实现确定性的路径处理
13	🌐 ellmos MCP 系列与同类项目矩阵	9 个同类 MCP 服务，涵盖 200 多种专用 Agent 工具
14	🧱 生态系统与合作套件	与 open-bricks 桌面套件、BACH 文本操作系统和 dev-bricks 工具集成
15	🔒 安全策略与事件报告	双语安全策略、私下披露漏洞、48 小时响应 SLA
16	📋 机器可读上下文（llms.txt）	标准化 LLM 索引，便于 Agent 发现和 RAG 爬虫抓取
17	🧪 验证与自动化测试	172+ 项 Vitest 测试、100% 全绿一致性，以及覆盖 Node.js 20、22、24 的多操作系统 CI 矩阵
18	⚖️ 第三方许可证与透明度	100% 宽松许可的 Level 1 SBOM、NOTICE 归属说明，以及法定 § 521 BGB 免责声明

目标用户画像与可发现性

用户画像	核心需求	解决的痛点	目标发现词
自主 AI Agent 与群组	非破坏性文件修复、预览优先的试运行、确定性的状态回执	格式错误的 JSON 导致 Agent 循环中断，未处理的编码乱码损坏项目文件	mcp json repair tool、local-first mcp file utilities、dry-run safe agent tools
全栈开发者	快速转换多种格式的配置文件（JSON/YAML/TOML/XML）、使用正则表达式批量重命名	多工具命令行语法繁琐、正则表达式循环耗时、Windows CRLF / BOM 污染	json to toml mcp、yaml xml conversion tool、batch regex rename mcp
DevOps 与发布工程师	自动计算多种哈希校验和（SHA-256/SHA-512）、文件夹差异比较、ZIP 检查	CI 运行器工具版本不一致、软件包哈希未经验证、外部归档工具臃肿	mcp sha256 checksum、folder diff mcp tool、zip archive mcp runner
安全与合规官员	100% 本地优先、气隙环境下通过 stdio 执行、零遥测、经过审计的宽松许可证	隐蔽的回传遥测、未知的供应链许可证、无法控制的网络出站流量	zero-egress mcp server、local-first claude mcp、permissive license mcp tools

对比矩阵与替代方案

维度	ellmos-clatcher-mcp	标准 Agent Shell	临时 CLI（jq/sed）	大型桌面应用	云端转换器 / API
主要接口	原生 MCP Stdio（JSON-RPC）	原始 Shell / Bash 执行	独立终端 CLI	GUI 应用窗口	HTTP REST / 网页
安全防护	内置默认值 dry_run: true	存在盲目覆盖风险	Shell 写入未经检查	通过 GUI 手动确认	远程服务存储
数据隐私与出站流量	100% 本地优先 / 零出站流量	本地执行	本地执行	本地执行	上传至远程云端
JSON 自动修复	基于 6 条规则的启发式修复	重新生成整个文件	复杂的 JQ 脚本	手动编辑语法	粘贴到第三方网页
编码规范化	无损修复乱码	猜测 / iconv	iconv / enca CLI	手动更改文件编码	网页 UTF-8 不一致
多格式转换	JSON/YAML/TOML/XML/CSV/INI	通过提示词重写	独立 CLI 软件包	复杂的文件导出	受速率限制的云端 API
重复项检测	SHA-256 哈希聚类	无（自定义脚本）	自定义 bash / find	独立工具（Anti-D）	不支持
正则表达式批量重命名	分阶段重命名器，支持试运行	依次执行 mv 循环	rename / sed 脚本	GUI 批量重命名工具	不支持
多操作系统一致性	Windows、Linux、macOS	Shell 语法差异	以 Linux 为中心的工具集	特定操作系统的二进制文件	依赖浏览器
许可证与安全审计	100% 宽松的 MIT / BSD 许可证	不一 / 未经审计	GPL / 混合工具链	混合 / 专有	闭源商业 SaaS

系统架构与数据流

ASCII 四视图架构拓扑

+--------------------------------------------------------------------------------------------------+
|                              ELLMOS CLATCHER MCP ARCHITECTURAL TOPOLOGY                          |
+--------------------------------------------------------------------------------------------------+
| [VIEW 1: CALLER RUNTIMES & AGENT CLIENTS]                                                        |
|   * Autonomous Agents   : Claude Code, OpenAI Codex, Antigravity / Gemini, Kimi, Cursor          |
|   * Agent Frameworks    : AutoGen, CrewAI, LangChain, LlamaIndex, Custom Python / TS Clients    |
|   * Transport Protocols : Model Context Protocol (MCP stdio), JSON-RPC 2.0 Framing               |
|   * Tool Surface        : 12 Specialized Agent Tools (file repair, formatting, hash & archives)  |
|   * Schema Contract     : Stdio transport, dynamic runtime Zod schema validation & parameter guards|
+--------------------------------------------------------------------------------------------------+
|                                                |                                                 |
|                                                v                                                 |
+--------------------------------------------------------------------------------------------------+
| [VIEW 2: CLATCHER MCP CORE ENGINE & TOOL DISPATCH ORCHESTRATOR]                                  |
|   * Protocol Dispatch   : ESM stdio router with Zod schema validation & parameter checking      |
|   * Safety Interceptor  : Built-in Dry-Run Guard (INV-DRYRUN-01) defaulting mutating tools to preview|
|   * Fault Diagnostics   : Multi-pass JSON syntax linter & self-healing AST repair pipeline       |
|   * Encoding Resolver   : Lossless UTF-8 normalization, BOM stripper & German umlaut Mojibake fix|
|   * Format Converter    : Bi-directional translation across 6 formats (JSON, YAML, TOML, XML...)|
+--------------------------------------------------------------------------------------------------+
|                                                |                                                 |
|                                                v                                                 |
+--------------------------------------------------------------------------------------------------+
| [VIEW 3: RUNTIME UTILITIES, FORMAT CONVERTERS & ATOMIC REPAIR PIPELINE]                          |
|   * Atomic File Ops     : Staged temporary buffer writes before replacement (INV-ATOMIC-04)      |
|   * Traversal Guard     : Archive extraction & batch rename strictly bounded to root trees       |
|   * Duplication Analysis: Collision-resistant SHA-256 cluster detection across workspace files   |
|   * Cryptographic Hashes: Native multi-algorithm digest verification (SHA-256, SHA-512, MD5, SHA-1)|
|   * Directory Diffs     : Fast recursive folder structural and content delta comparison engine   |
|   * In-Memory Archives  : Streamlined ZIP creation, inspection, and extraction with adm-zip      |
+--------------------------------------------------------------------------------------------------+
|                                                |                                                 |
|                                                v                                                 |
+--------------------------------------------------------------------------------------------------+
| [VIEW 4: AIR-GAP DEFENSE PERIMETER, RUNASINVOKER & ZERO-EGRESS GOVERNANCE]                       |
|   * Execution Privilege : RunAsInvoker unprivileged user-mode (Zero administrative elevation)    |
|   * Transport Boundary  : 100% Local stdio transport, zero telemetry, zero open listening ports  |
|   * Air-Gap Isolation   : 100% Offline execution, zero outbound network sockets, zero egress     |
|   * Statutory Protection: § 521 BGB gratuitous open-source liability disclaimer & 48h SLA        |
|   * Governance & Supply : Level 1 SBOM, 100% permissive runtime (MIT/BSD), NOTICE attribution    |
+--------------------------------------------------------------------------------------------------+

组件数据流图

graph TD
    Agent["AI Agent / Claude Code / Cursor / IDE"] -->|"MCP JSON-RPC Protocol over Stdio"| Transport["MCP Stdio Transport Layer"]
    Transport --> Server["Clatcher MCP Server Runtime"]
    Server --> Dispatcher{"Tool Dispatcher"}

    Dispatcher -->|"fix_json / cleanup_file"| JsonEngine["JSON Linter & Auto-Fix Engine"]
    Dispatcher -->|"fix_encoding / fix_umlauts"| EncodingEngine["Encoding Normalizer & Mojibake Resolver"]
    Dispatcher -->|"convert_format"| FormatEngine["Format Converter: JSON/YAML/TOML/XML/CSV/INI"]
    Dispatcher -->|"detect_dupes / checksum"| HashEngine["SHA-256 / Multi-Hash Content Engine"]
    Dispatcher -->|"folder_diff / batch_rename"| FileOpsEngine["Folder Diff & Regex Batch Renamer"]
    Dispatcher -->|"archive / zip"| ArchiveEngine["AdmZip Compression Handler"]
    Dispatcher -->|"scan_emoji / regex_test"| RegexEngine["Emoji Scanner & Regex Debugger"]

    JsonEngine --> DryRunGuard{"Dry-Run Guard"}
    EncodingEngine --> DryRunGuard
    FormatEngine --> DryRunGuard
    FileOpsEngine --> DryRunGuard
    ArchiveEngine --> DryRunGuard

    DryRunGuard -->|"dry_run: true (default)"| PreviewReport["Detailed Dry-Run Preview Diff & Status"]
    DryRunGuard -->|"dry_run: false (explicit)"| DiskWrite["Safe Atomic Filesystem Write"]

端到端执行序列

sequenceDiagram
    autonumber
    actor User as Developer / Agent Orchestrator
    participant Agent as AI Coding Agent (Claude Code / Cursor)
    participant Stdio as MCP Stdio Protocol (JSON-RPC)
    participant Clatcher as Clatcher MCP Server
    participant Validator as Zod Schema Validator
    participant Engine as Dedicated Tool Engine
    participant Guard as Dry-Run Safety Guard
    participant FS as Local Filesystem

    User->>Agent: Prompt: "Fix broken encoding and trailing commas in config.json"
    Agent->>Stdio: CallTool(name="fix_json", args={path: "config.json", dry_run: true})
    Stdio->>Clatcher: Dispatch JSON-RPC Request
    Clatcher->>Validator: Validate arguments (Zod schema)
    Validator-->>Clatcher: Validated inputs

    Clatcher->>Engine: Run JSON repair pipeline
    Engine->>FS: Read target file content (UTF-8)
    FS-->>Engine: Raw file bytes / string
    Engine->>Engine: Strip comments, trailing commas, single quotes, NULs
    Engine->>Guard: Submit repaired AST / string

    alt dry_run == true (Default Mode)
        Guard->>Guard: Generate diff & mutation preview
        Guard-->>Clatcher: Return diff preview without disk write
    else dry_run == false (Explicit Agent Mutation)
        Guard->>FS: Atomic write to target file via temp buffer
        FS-->>Guard: Write successful
        Guard-->>Clatcher: Return success receipt + bytes written
    end

    Clatcher-->>Stdio: JSON-RPC ToolResult (diff, stats, safety report)
    Stdio-->>Agent: Formatted MCP response
    Agent-->>User: Synthesized result & proposed next steps

核心不变量与安全保障

不变量	保障	强制机制
默认试运行保护	修改工具绝不会在不告知的情况下更改文件	所有修改工具（batch_rename、cleanup_file、fix_json、fix_encoding、fix_umlauts、convert_format、archive）默认启用 dry_run: true。必须显式设置 dry_run: false 才会提交更改。
零外发与本地优先	不发送任何外部遥测数据，也不进行网络调用	通过 stdio 进行 100% 离线 JSON-RPC 处理。不发送遥测信标，不请求外部 API，不建立任何出站网络套接字。
路径遍历防护	严格限制在已授权的文件树内	归档和批量操作会验证目标边界，并针对基准根目录安全解析相对路径。
原子操作	能够抵御写入中断	修改流程会先写入暂存临时文件，再替换目标文件，避免产生写入不完整或已损坏的输出。
不提权的用户模式	仅需最低限度的 OS 权限	完全使用当前执行用户的标准权限运行，不请求 sudo/Administrator 权限。
编码保留	无损往返字符编码	修复 Windows cp1252 问题、BOM 问题和德语变音字母（ä, ö, ü, ß），同时保留原始 UTF-8 字节顺序。
多哈希完整性	位级加密验证	支持使用 SHA-256、SHA-512、MD5 和 SHA-1 算法进行校验和验证。
多操作系统一致性	在不同 OS 平台上行为一致	持续在 Linux（ubuntu-latest）、Windows（windows-latest）和 macOS（macos-latest）上测试，并原生处理路径分隔符。
失败即关闭的参数验证	执行前拒绝无效参数	Zod 架构验证强制执行严格约束，拒绝格式错误的路径和类型，并防止部分执行。
确定性的错误边界与回执	每次运行均提供结构化诊断报告	工具返回契约保持不变：每次调用都会返回结构化 JSON-RPC 负载、差异预览、字节数和可验证回执。

工具

工具	描述
fix_json	修复损坏的 JSON：去除注释、尾随逗号、单引号、BOM/NUL
fix_encoding	修复编码问题：移除 BOM、修复 UTF-8 二次编码和 cp1252 问题
fix_umlauts	修复二次编码导致的损坏德语变音字母（例如 ä -> ä）
convert_format	在 JSON、YAML、TOML、XML、CSV 和 INI 之间转换
detect_dupes	按内容哈希（SHA256）查找重复文件，并按相同内容分组
folder_diff	比较两个目录，或创建快照并在下次调用时进行差异比较
batch_rename	使用正则表达式模式重命名文件，并提供试运行预览
archive	创建、解压或列出 ZIP 归档文件
checksum	计算文件哈希（SHA256、MD5、SHA1、SHA512），并可选择进行验证
cleanup_file	移除 BOM、尾随空白、修复换行符并去除 NUL 字节
scan_emoji	查找代码文件中的表情符号字符
regex_test	针对文本测试正则表达式模式，显示所有匹配项及其分组

所有具有破坏性的工具默认启用试运行模式，必须显式设置 dry_run: false 才会写入更改。

安装

Claude Code CLI

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

Claude Desktop / Cursor 配置

将 Clatcher 添加到 claude_desktop_config.json 或 Cursor MCP 设置中：

{
  "mcpServers": {
    "clatcher": {
      "command": "npx",
      "args": ["-y", "ellmos-clatcher-mcp"]
    }
  }
}

npm（全局安装）

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

从源代码安装

git clone https://github.com/ellmos-ai/ellmos-clatcher-mcp.git
cd ellmos-clatcher-mcp
npm install
npm run build
node dist/index.js

实用工作流

Clatcher 提供确定性的单步实用操作，专为 AI 编码工作流设计：

1. JSON 自动修复（fix_json）

自主 Agent 运行时常会遇到配置文件问题，例如尾随逗号、单引号键或内联 JavaScript 注释：

{
  "name": "fix_json",
  "arguments": {
    "path": "tsconfig.json",
    "dry_run": false
  }
}

结果： 解析并移除注释和尾随逗号，生成严格符合规范的 JSON，并验证写入的字节数。

2. 无损字符编码规范化（fix_encoding / fix_umlauts）

修复 Windows cp1252 乱码、BOM 文件头以及 UTF-8 双重编码序列，不丢失数据：

{
  "name": "fix_umlauts",
  "arguments": {
    "path": "docs/Anleitung.md",
    "dry_run": false
  }
}

结果： 将 ä、ö、ü、ß 等损坏序列还原为干净的 UTF-8 字符 ä、ö、ü、ß。

3. 多格式配置转换（convert_format）

一次性在 JSON、YAML、TOML、XML、CSV 和 INI 之间转换结构化数据：

{
  "name": "convert_format",
  "arguments": {
    "source_path": "config.yaml",
    "target_format": "json",
    "dry_run": false
  }
}

4. 重复项检测与加密哈希（detect_dupes / checksum）

扫描目标目录树，使用 SHA-256 哈希聚类识别相同内容，且不会通过网络传输数据：

{
  "name": "detect_dupes",
  "arguments": {
    "directory": "src/assets"
  }
}

5. 安全的正则表达式批量重命名（batch_rename）

使用正则表达式模式预览并暂存批量文件重命名：

{
  "name": "batch_rename",
  "arguments": {
    "directory": "reports",
    "pattern": "^draft_(.*)\\.txt$",
    "replacement": "final_$1.txt",
    "dry_run": true
  }
}

试运行协议与安全验证

ellmos-clatcher-mcp 中所有会修改内容的工具都强制采用先预览后操作约定（默认 dry_run: true）：

1. 安全预览： 不带参数调用 fix_json、cleanup_file、batch_rename、fix_encoding 或 archive，会返回详细的统一差异和修改预览，不会触碰磁盘。
2. 明确选择： 只有 Agent 明确提供 dry_run: false 时才会写入文件系统。
3. 失败关闭式参数验证： 严格清理路径参数，防止路径遍历（.. 越界），并将路径限制在项目目录范围内。
4. 生成回执： 每次修改操作都会生成权威 JSON 回执，详细说明读取和写入的字节数，以及加密验证状态。

编码、乱码与格式转换

Clatcher 集成了专用字符串处理原语，用于修复跨平台文本损坏问题：

• 移除 BOM： 自动移除 UTF-8 BOM 文件头（0xEF, 0xBB, 0xBF），避免其导致旧版 CLI 解析器和 CI 检查器出错。
• 乱码修复： 重构因将 UTF-8 文本误解为 ISO-8859-1 或 Windows-1252 而损坏的多字节序列。
• 统一换行符： 将混用 Windows CRLF（\r\n）和 Unix LF（\n）的文件统一转换为换行符。
• 移除 NUL 字节： 清理因网络流中断或磁盘块损坏而意外插入的二进制 NUL 字符。

多操作系统支持与 Windows 路径健壮性

持续在 Linux、macOS 和 Windows 上验证跨平台一致性：

• 路径规范化： 使用原生 Node.js path 模块透明地解析反斜杠（\）和正斜杠（/）。
• 长路径支持： 在 Windows 深层嵌套结构中安全运行，不受 MAX_PATH（260 个字符）截断影响。
• 非特权运行： 在标准用户权限（RunAsInvoker）下运行，无需管理员提升权限或 root 访问权限。

ellmos MCP 家族与同类项目矩阵

属于 ellmos MCP 家族：

服务	工具	侧重点	npm
ellmos-filecommander-mcp	50	文件系统操作、进程管理、交互式会话	ellmos-filecommander-mcp
ellmos-codecommander-mcp	22	代码分析、AST 解析、导入管理	ellmos-codecommander-mcp
ellmos-clatcher-mcp	12	实用工具：修复、转换、检测、批量操作	ellmos-clatcher-mcp
n8n-manager-mcp	19	通过 AI 助手管理 n8n 工作流	n8n-manager-mcp
ellmos-controlcenter-mcp	34	MCP 技术栈发现、配置管理、控制平面	ellmos-controlcenter-mcp
ellmos-homebase-mcp	51	大模型记忆、知识、状态、路由与编排	ellmos-homebase-mcp（alpha）
ellmos-servercommander-mcp	8	服务操作：部署试运行、邮件状态、日志分析、运行状况检查	ellmos-servercommander-mcp（alpha）
ellmos-blender-use-mcp	4	无头模式下的 Blender 资产 QA 与 FBX 重新导入验证	ellmos-blender-use-mcp（alpha）
open-compute-mcp	16	模型无关的计算机操作：捕获、安全门控操作、Windows UIA	open-compute-mcp（alpha）

每个服务都覆盖不同的领域。请根据工作流使用一个服务、一对专用服务，或完整的服务家族。

ellmos-ai 生态系统

此 MCP 服务属于 ellmos-ai 生态系统，涵盖 AI 基础设施、MCP 服务和智能工具。

AI 基础设施

项目	描述
BACH	面向大模型 Agent 的本地优先文本式操作系统 — 113+ 个处理器、550+ 个工具、SQLite 记忆
open-compute	模型无关的计算机操作核心，为 Open Compute MCP 提供支持
clutch	提供商中立的大模型编排，支持自动路由和预算跟踪
rinnsal	轻量级 Agent 记忆、连接器和自动化基础设施
ellmos-stack	可自托管的 AI 研究技术栈（Ollama + n8n + Rinnsal + KnowledgeDigest）
MarbleRun	面向 Claude Code 的自主 Agent 链框架
gardener	极简的数据库驱动型大模型操作系统原型（4 个函数、1 张表）
ellmos-tests	大模型操作系统测试框架（7 个维度）

桌面软件与姊妹生态

我们的合作组织 open-bricks 及姊妹套件集合了 AI 原生应用和开发者工具：

仓库	重点	状态
file-bricks/ProFiler	支持智能工作区的多栏 PySide6 桌面文件管理器	活跃
doc-bricks/DokuZen	文档转换、批量 OCR、元数据清理	活跃
dev-bricks/safe-start-for-codex	安全工作区预检和 Agent 启动门控	活跃
dev-bricks/DevCenter	集中式开发控制台和服务管理器	活跃
dev-bricks/CodeBox	沙盒代码执行和容器化工作环境	活跃
dev-bricks/Zombie Killer Tray	用于检查孤立 MCP 进程的可选 Windows 工具。通过受支持的 node_modules/ellmos-clatcher-mcp/dist/index.js 入口启动时，Clatcher 是一个已配置的候选项；所有额外的进程检查和应用检查仍然适用	可选

安全政策

有关安全漏洞披露渠道、受支持版本和 48 小时响应 SLA，请参阅 SECURITY.md。有关开发指南、质量门禁和不变量约定，请参阅 CONTRIBUTING.md。

机器可读上下文（llms.txt）

此仓库提供标准化的机器可读上下文文件，供 AI Agent、爬虫和 RAG 索引器使用：

• llms.txt：简明清单，列出全部 12 个工具、试运行安全不变量、姊妹 MCP 工具数量以及 CLI 调用示例。

测试

npm test

172 项测试覆盖全部 12 个工具、i18n 语言包、仓库规范和元数据一致性（vitest）。GitHub Actions 工作流会在 Node.js 20、22 和 24 上运行 npm ci、TypeScript 构建、Vitest 和 npm 包试运行。

要求

• Node.js >= 20

许可证

MIT

第三方许可证与透明度

ellmos-clatcher-mcp 严格遵循 open-bricks 和 ellmos-ai 的开源治理标准。全部 7 个直接运行时依赖项和 5 个开发依赖项均采用宽松许可证（MIT、BSD-3-Clause、BSD-2-Clause、Apache-2.0），不含任何著佐权许可证（GPL/AGPL 占比为 0%），也不包含云端遥测。

正式版权声明和生态归属信息已载入 NOTICE。有关完整依赖项清单、SPDX 标识符、Level 1 SBOM 交叉引用矩阵和完整许可证文本，请参阅 THIRD_PARTY_LICENSES.md 以及纯文本版本 THIRD_PARTY_LICENSES.txt。

可发现性

• npm： ellmos-clatcher-mcp
• GitHub： ellmos-ai/ellmos-clatcher-mcp
• MCP Registry 元数据： server.json 声明了官方软件包标识 io.github.ellmos-ai/ellmos-clatcher-mcp。
• Glama.ai Registry： 面向 Glama MCP 生态系统的清单文件 glama.json。
• 大模型索引： llms.txt 为 Agent 和 Registry 爬虫概述了工具范围。

主要搜索词：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.md。

责任 / Liability

本项目是根据德国《民法典》第 516 条及后续条款提供的无偿开源赠与。根据**《德国民法典》第 521 条**，作者的责任仅限于故意和重大过失。此外，MIT 许可证中的免责声明亦适用。

使用风险由您自行承担。不承诺维护，不保证可用性，也不保证无错误或适用于特定用途。

本项目是根据德国法律提供的无偿开源赠与。责任仅限于故意和重大过失（《德国民法典》第 521 条）。MIT 许可证中的免责声明适用。

使用风险由您自行承担。不提供担保，不承诺维护或保证可用性，也不保证适用于特定用途。