json-mender-mcp

JSON Mender MCP — 为 AI Agent 修复格式错误的 JSON、验证 JSON Schema、测试正则表达式

免费的本地 MCP 服务，可修复大模型输出的错误 JSON、根据真正的 JSON Schema 验证数据，并以确定性方式测试正则表达式——无需 API 密钥、网络调用或遥测。

如果你正在构建 AI Agent，却总是遇到 JSONDecodeError、未终止的字符串、尾随逗号或模型输出中未加引号的键名，那么这个 MCP 服务就是为解决这一问题而打造的。

与 polymath-megablaster-mcp 一样，秉持本地优先、确定性的理念，但专门用于解决“模型写出的 JSON 无法解析”这一问题。

解决的问题

大模型——尤其是较小型或本地模型（Llama、Qwen、Mistral）——经常会生成看起来正确、却无法解析的 JSON：尾随逗号、用单引号代替双引号、内部引号未转义、缺少逗号、输出被截断。让模型“修复 JSON”通常只会得到第二份错误结果。repair_json 每次都会以确定性的方式修复它，始终采用相同的方法，无需再次调用模型。

工具

• repair_json — 修复格式错误或无效的 JSON（尾随逗号、未加引号的键名、未转义的引号、被截断的结构），并返回已修正且解析后的结果。基于 jsonrepair 构建。
• validate_regex — 以确定性方式针对一个或多个字符串测试正则表达式。此工具很实用，因为模型经常会写出能够编译、却无法匹配其预期内容的正则表达式。
• validate_against_schema — 使用真正的 JSON Schema 验证任意 JSON 数据（通过使用最广泛的 JS Schema 验证器 ajv），并获取精确到字段、易于理解的错误消息，而不是笼统的通过或失败结果。

设置

1. 安装 Node.js（v18+），如果尚未安装，请访问：https://nodejs.org

2. 克隆并安装：

git clone https://github.com/headlessherm-creator/json-mender-mcp.git
cd json-mender-mcp
npm install

3. 将 MCP 客户端指向此服务：

{
  "mcpServers": {
    "json-mender": {
      "command": "node",
      "args": ["/path/to/json-mender-mcp/src/index.js"]
    }
  }
}

常见客户端的设置文档：

• Claude Desktop：https://modelcontextprotocol.io/quickstart/user
• Cursor：https://docs.cursor.com/context/model-context-protocol
• Claude Code：https://docs.claude.com/en/docs/claude-code/mcp

为什么选择本地运行

src/tools.js 中没有任何 fetch/http 导入——每个工具都使用 jsonrepair 和 ajv 进行纯本地计算；这两个 npm 包均成熟可靠且维护活跃。通过此服务发送的任何内容都不会离开你的设备。

关键词

JSON 修复 MCP 服务、修复大模型生成的错误 JSON、格式错误的 JSON 解析器、JSON Schema 验证 MCP、正则表达式测试器 MCP、无需 API 密钥的本地 MCP 服务、Claude MCP JSON 工具、AI Agent 结构化输出验证。

相关工具

秉持相同的本地优先理念，解决不同问题：

• polymath-megablaster-mcp — 确定性的数学、日期、单位换算和网络功能
• hiring-mender-mcp — BambooHR + Greenhouse ATS 写入工具，统一词汇
• helpdesk-mender-mcp — Zendesk + Freshdesk + Help Scout 写入工具，统一词汇

许可证

MIT