MCP JSON Tools

基本能力

产品定位

MCP JSON Tools 是一个用于本地 JSON 文件交互的工具集，提供强大的数据操作和查询功能。

核心功能

• 查询: 使用标准 JSONPath 表达式查询数据 (mcp_json_query)。
• 检查: 获取 JSON 结构中的值和路径 (mcp_json_nodes)。
• 分析和修改 JSON: 在沙盒化的 VM 中执行 JavaScript 代码，支持复杂分析和修改 (mcp_json_eval, mcp_json_multi_eval)。
• 支持 NDJSON: 读取、分析和修改 NDJSON 文件 (mcp_ndjson_eval)。
• 安全执行: 使用 Node.js vm 模块进行安全的代码执行，可配置超时。
• 简单设置: 通过 npx 作为标准 Node.js 进程运行。

适用场景

• 需要快速查询和分析本地 JSON 文件的场景。
• 需要对 JSON 或 NDJSON 文件进行复杂修改的场景。
• 需要安全执行 JavaScript 代码进行数据处理的场景。

工具列表

1. mcp_json_query: 执行 JSONPath 查询，返回匹配的值。
2. mcp_json_nodes: 执行 JSONPath 查询，返回匹配的节点（值和路径）。
3. mcp_json_eval: 在沙盒化的 VM 中执行 JavaScript 代码，支持修改 JSON 文件。
4. mcp_json_multi_eval: 在沙盒化的 VM 中执行 JavaScript 代码，支持修改多个 JSON 文件。
5. mcp_ndjson_eval: 读取和处理 NDJSON 文件，支持修改文件内容。

常见问题解答

• 文件路径问题: 使用 npx 时，文件路径必须为绝对路径。
• 安全警告: 所有 eval 工具执行用户提供的代码，需谨慎使用。

使用教程

使用依赖

1. 安装 Node.js（版本 18 或更高）。
2. 克隆仓库：git clone https://github.com/zfirsty/mcp-json-tools.git
3. 进入目录：cd mcp-json-tools
4. 安装依赖：npm install

安装教程

1. 使用 npx 运行工具（推荐）： json { "mcpServers": { "jsonTools": { "description": "Tools to query, inspect, and modify local JSON files.", "command": "npx", "args": [ "mcp-json-tools" ] } } }
2. 使用 Node 直接运行（不推荐）： json { "jsonTools": { "description": "Tools to query, inspect, and modify local JSON files.", "command": "node", "args": [ "/abs/path/to/mcp-json-tools/index.js" ] } }

调试方式

1. 使用 mcp_json_query 查询数据： bash npx mcp-json-tools mcp_json_query --file_path="test-data/store.json" --json_path="$.store.book[*].author"
2. 使用 mcp_json_eval 修改数据： bash npx mcp-json-tools mcp_json_eval --file_path="test-data/store.json" --js_code="_.forEach($1.store.book, (book) => { book.onSale = false; }); ({ type: 'updateFile', data: $1 });"

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。