json

mcp-json-tools

一个 MCP（Model Context Protocol）服务，为 AI Agent 提供 JSON 和数据处理工具。适用于 Claude Code、Claude Desktop 以及任何兼容 MCP 的客户端。

工具

工具	描述
json_validate	根据 JSON Schema 验证 JSON 数据，并返回包含路径的详细错误信息
json_diff	比较两个 JSON 对象，显示新增、移除和变更的内容及其路径
json_transform	使用 pick、rename、flatten 和 unflatten 操作转换 JSON
csv_to_json	将 CSV 文本转换为 JSON 数组，可配置表头、分隔符和类型转换
json_to_csv	将 JSON 对象数组转换为 CSV 文本
yaml_to_json	将 YAML 文本转换为 JSON
json_to_yaml	将 JSON 文本转换为 YAML

安装

npm install
npm run build

在 Claude Code 中使用

claude mcp add json-tools -- node D:/products/mcp-servers/mcp-json-tools/dist/index.js

在 Claude Desktop 中使用

将以下内容添加到 Claude Desktop 配置文件中：

Windows： %APPDATA%\Claude\claude_desktop_config.json macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "json-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-json-tools/dist/index.js"]
    }
  }
}

工具详情

json_validate

根据 JSON Schema 验证 JSON 数据。返回一个 valid 布尔值和一个错误数组，每条错误都包含字段路径、错误消息以及验证失败的 Schema 关键字。

参数：

• data（string）——要验证的 JSON 数据
• schema（string）——用于验证的 JSON Schema

json_diff

比较两个 JSON 对象并生成结构化差异。每项差异都包含点分隔表示法的路径、变更类型（新增、移除或变更）以及旧值和新值。

参数：

• original（string）——原始 JSON 对象
• modified（string）——修改后的 JSON 对象

json_transform

对 JSON 数据应用转换。支持四种操作：

• pick — 按点分隔表示法路径提取指定字段
• rename — 使用映射对象重命名顶层键
• flatten — 将嵌套对象展开为以点分隔的键
• unflatten — 将以点分隔的键还原为嵌套对象

参数：

• data（string）——要转换的 JSON 数据
• operation（string）——以下操作之一：pick、rename、flatten、unflatten
• fields（string[]）——用于 pick：要提取的字段路径
• mapping（object）——用于 rename：旧键到新键的映射
• separator（string）——用于 flatten/unflatten：分隔符（默认值："."）

csv_to_json

将 CSV 文本解析为 JSON 对象数组。

参数：

• csv（string）——要转换的 CSV 文本
• hasHeaders（boolean）——第一行是否为表头（默认值：true）
• delimiter（string）——列分隔符（默认值：","）
• castTypes（boolean）——是否自动转换数字和布尔值（默认值：false）

json_to_csv

将 JSON 对象数组转换为 CSV 文本。表头根据所有对象键的并集生成。

参数：

• data（string）——要转换的 JSON 数组
• delimiter（string）——列分隔符（默认值：","）
• includeHeaders（boolean）——是否包含表头行（默认值：true）

yaml_to_json / json_to_yaml

在 YAML 和 JSON 格式之间进行转换。

参数：

• yamlText / jsonText（string）——要转换的文本
• indent（number）——缩进空格数（默认值：2）

许可证

MIT