JSON Schema Tools

json-schema-tools MCP 服务

使用 Ajv 根据 JSON Schema draft 07、2019-09 和 2020-12 验证 JSON，从示例文档推断 schema，并比较两个 schema，对每项变更给出兼容性判定。

属于 dev-mcp-servers。仅支持 Stdio 传输；服务不会打开端口。

工具

工具	输入	返回内容
validate_json	schema、data、draft?	valid、使用的 draft、错误数量，以及最多 200 条错误，每条包含 JSON Pointer 路径、schema 路径、关键字、消息和参数。会检查格式（email、uri、date-time、uuid 等）。
infer_schema	samples（文档数组或 JSON 字符串）、enum_threshold?、detect_formats?、title?	draft 2020-12 schema：合并样例中的类型、对每个样例都存在的键设为 required、嵌套对象、数组项、字符串格式，以及可选的枚举。
diff_schemas	before、after	返回每项变更的路径、变更前后的值及影响：breaking、compatible 或 review。判定基准是符合 before 的文档。

安装

Claude Code：

claude mcp add json-schema-tools -- docker run --rm -i ghcr.io/basitalisandhu/mcp-json-schema-tools:0.2.2

添加 -s user，即可在每个项目中使用。任何可读取 .mcp.json 的客户端（Claude Code、Claude Desktop、Cursor）：

{
  "mcpServers": {
    "json-schema-tools": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/basitalisandhu/mcp-json-schema-tools:0.2.2"]
    }
  }
}

请按示例固定版本，避免更新在你不知情的情况下改变编辑器中运行的内容。该软件包尚未发布到 npmjs.com，因此 npx 不可用；GitHub Packages npm 的安装方法请参阅仓库 README。从检出目录构建时，请先在仓库根目录运行 npm install && npm run build，然后使用 "command": "node", "args": ["<path>/packages/json-schema-tools/dist/index.js"]。

涉及范围

• 网络：无。不会获取远程 $ref 目标。
• 本地文件：无。
• 遥测：无。

说明

• Ajv 使用 strict: false 运行，因此包含未知关键字的实际 schema 仍可通过验证。
• 不接受 Draft-04 和 Draft-06 schema；请更新 $schema 或将其移除。
• Schema 和文档可以作为 JSON 值或 JSON 字符串传入；两者的大小上限均为 2 MB。

构建和测试

npm install        # at the repository root
npm run build -w @basitalisandhu/mcp-json-schema-tools
npm test -w @basitalisandhu/mcp-json-schema-tools

测试使用 node:test 和 SDK 的内存传输，不会访问网络。

许可证

MIT。请参阅 LICENSE。