Skip to main content
Glama

🚀 MCP JSON Maker

📖 项目介绍

这是一个强大的 MCP (Model Context Protocol) 工具,专门为AI提供JSON构建、编辑和批量生成能力。它允许AI创建、管理、编辑和批量生成JSON数据,支持多种输出格式和高级规则引擎。

NPM 仓库地址: @zb2947244682/mcp-json-maker

Related MCP server: Divide and Conquer MCP Server

🧠 核心功能

此 MCP 服务提供了完整的JSON管理系统:

🔧 JSON操作工具

  • item_operations - 通用工具,支持JSON和模板的完整CRUD操作

    • 创建、获取、列表、编辑、删除、统计

    • 支持节点级操作(如 users.0.name

    • 智能参数验证和错误提示

📊 批量生成工具

  • batch_generate_json - 根据模板和规则批量生成JSON数据

    • 支持基于现有模板生成

    • 支持规则引擎动态生成

    • 支持数据类型定义、约束条件和变化选项

📁 文件导出工具

  • export_to_file - 将JSON数据导出到文件

    • 支持多种格式:JSON、JSONL、CSV

    • 支持绝对路径和相对路径

    • 支持指定行号插入内容

    • 自动创建目录结构

🚀 使用场景

1. 大模型JSON生成辅助

  • 快速创建标准化的JSON结构

  • 批量生成测试数据

  • 支持复杂的嵌套结构

2. 批量数据处理

  • 根据规则批量生成数据

  • 支持数据变化和约束

  • 高效的数据转换和导出

3. JSON数据编辑和管理

  • 节点级精确编辑

  • 支持数组和对象操作

  • 完整的版本控制

4. 数据格式转换

  • JSON到CSV转换

  • JSON到JSONL转换

  • 支持美化输出

⚙️ 配置说明

在 Cursor 中配置

将以下配置添加到您的 Cursor mcp.json 文件中:

{
  "mcp-json-maker": {
    "command": "npx",
    "args": [
      "-y",
      "@zb2947244682/mcp-json-maker@latest"
    ]
  }
}

通过 npx 直接运行

您可以通过以下命令直接从命令行运行此 MCP 项目:

npx @zb2947244682/mcp-json-maker@latest

本地开发配置

如果您在本地开发环境中使用,可以将以下配置添加到您的 Cursor mcp.json 文件中:

{
  "mcp-json-maker": {
    "command": "node",
    "args": ["D:\\Codes\\MCPRepo\\mcp-json-maker\\index.js"]
  }
}

📊 数据结构

JSON数据结构

{
  "id": "唯一标识",
  "name": "JSON名称",
  "content": "JSON内容对象",
  "description": "描述信息",
  "tags": ["标签1", "标签2"],
  "size": "内容大小",
  "createdAt": "创建时间",
  "updatedAt": "更新时间"
}

模板数据结构

{
  "id": "唯一标识",
  "name": "模板名称",
  "content": "模板JSON结构",
  "description": "模板描述",
  "variables": ["变量1", "变量2"],
  "category": "分类",
  "createdAt": "创建时间",
  "updatedAt": "更新时间"
}

生成规则结构

{
  "structure": "JSON结构描述",
  "data_types": {
    "field1": "string",
    "field2": "number",
    "field3": "array"
  },
  "constraints": {
    "field1": {"min": 1, "max": 100},
    "field2": {"pattern": "^[^@]+@[^@]+\\.[^@]+$"}
  },
  "variations": {
    "field1": ["选项1", "选项2", "选项3"],
    "field2": ["城市1", "城市2", "城市3"]
  }
}

🔧 特性

  • ✅ 完整的CRUD操作支持

  • ✅ 节点级精确编辑

  • ✅ 智能批量生成

  • ✅ 多格式文件导出

  • ✅ 规则引擎支持

  • ✅ 模板管理系统

  • ✅ 友好的中文界面

  • ✅ 完善的错误处理

  • ✅ 高性能内存存储

  • ✅ 自动路径处理

📈 性能指标

  • 响应时间: 1-3ms

  • 支持JSON数: 无限制

  • 支持模板数: 无限制

  • 批量生成速度: 1000个/秒

  • 搜索速度: 毫秒级

  • 内存占用: 最小化

🎯 使用示例

创建JSON数据

{
  "tool": "item_operations",
  "parameters": {
    "action": "create",
    "item_type": "json",
    "name": "用户配置",
    "content": "{\"name\": \"张三\", \"age\": 25, \"email\": \"zhangsan@example.com\"}",
    "description": "用户基本信息配置",
    "tags": ["user", "config", "test"]
  }
}

编辑JSON节点

{
  "tool": "item_operations",
  "parameters": {
    "action": "edit",
    "item_type": "json",
    "id": "your_json_id",
    "path": "age",
    "operation": "set",
    "value": 26
  }
}

批量生成JSON

{
  "tool": "batch_generate_json",
  "parameters": {
    "count": 5,
    "rules": {
      "structure": "用户信息结构,包含姓名、年龄、邮箱等字段",
      "data_types": {
        "name": "string",
        "age": "number",
        "email": "string"
      },
      "constraints": {
        "age": {"min": 18, "max": 65}
      },
      "variations": {
        "name": ["张三", "李四", "王五", "赵六", "钱七"],
        "city": ["北京", "上海", "广州", "深圳", "杭州"]
      }
    },
    "output_format": "array"
  }
}

导出到文件

{
  "tool": "export_to_file",
  "parameters": {
    "json_ids": ["id1", "id2", "id3"],
    "file_path": "D:/data/users.json",
    "format": "json",
    "pretty_print": true
  }
}

🔍 高级功能

节点路径操作

支持复杂的嵌套路径操作:

  • 简单字段:"name"

  • 嵌套对象:"user.profile.age"

  • 数组元素:"users.0.name"

  • 混合路径:"config.database.0.host"

编辑操作类型

  • set - 设置值

  • add - 添加元素(数组操作)

  • remove - 删除值

  • update - 更新对象属性

输出格式支持

  • JSON - 标准JSON格式,支持美化输出

  • JSONL - 每行一个JSON对象

  • CSV - 逗号分隔值(支持扁平结构)

🎯 开发原则

核心原则:少工具,多功能

  • 一个工具完成多种相关操作

  • 参数复用最大化

  • 智能默认值设置

  • 条件参数设计

用户体验优先

  • 详细的参数说明和示例

  • 友好的错误提示和解决建议

  • 完整的操作指导

  • 丰富的调试信息

🔮 未来计划

  • 数据持久化支持

  • 高级规则引擎

  • 语义分析功能

  • 数据导入功能

  • 多用户支持

  • 权限管理

  • 版本控制

  • 协作编辑

🤝 贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目!

📄 许可证

本项目采用 MIT 许可证。


让AI拥有强大的JSON构建和管理能力,构建智能的数据处理系统! 🚀

Available Tools

3 tools
batch_generate_json批量生成JSONB

根据模板和规则批量生成JSON数据。支持基于现有模板生成或根据规则动态生成。适用于测试数据生成、批量数据处理等场景。

ParametersJSON Schema
NameRequiredDescriptionDefault
countYes生成数量:要生成的JSON数量,建议从少量开始测试
output_formatNo输出格式:array(批量保存)、individual(单独保存,每个JSON独立)array
rulesYes生成规则:定义JSON生成的具体规则和约束
template_idNo模板ID:可选,如果提供则基于现有模板生成。使用item_operations工具查看可用模板

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions support for template-based and rule-based generation, but doesn't describe critical behaviors like whether this is a read-only or mutating operation, what permissions are required, rate limits, error handling, or what the output looks like. For a tool with no annotations and complex parameters, this is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise and well-structured in two sentences. The first sentence states the core purpose, and the second provides usage scenarios. There's no wasted text, and it's front-loaded with the main functionality.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (4 parameters, nested objects, no output schema, and no annotations), the description is incomplete. It doesn't explain what the tool returns, how errors are handled, or behavioral constraints. For a data generation tool with significant parameter complexity, more context is needed to help an agent use it effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all parameters thoroughly. The description adds minimal value beyond the schema, mentioning '基于现有模板生成或根据规则动态生成' (generate based on existing templates or dynamically based on rules), which loosely maps to 'template_id' and 'rules' parameters. Since the schema does the heavy lifting, the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: '根据模板和规则批量生成JSON数据' (batch generate JSON data based on templates and rules). It specifies the verb (generate), resource (JSON data), and scope (batch). However, it doesn't explicitly differentiate from sibling tools like 'export_to_file' or 'item_operations', which might have overlapping functionality.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides some usage context: '适用于测试数据生成、批量数据处理等场景' (suitable for test data generation, batch data processing, etc.). This implies when to use the tool, but it doesn't explicitly state when NOT to use it or mention alternatives like sibling tools. The guidance is helpful but not comprehensive.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

export_to_file导出JSON到文件B

将JSON数据导出到指定文件,支持多种格式和插入位置。支持绝对路径和相对路径,自动创建不存在的目录。

ParametersJSON Schema
NameRequiredDescriptionDefault
file_pathYes目标文件路径:支持绝对路径(如'D:/data/export.json')或相对路径(如'./output/export.json')。相对路径相对于当前工作目录
formatNo输出格式:json(标准JSON格式)、jsonl(每行一个JSON)、csv(逗号分隔值,仅支持扁平结构)json
insert_lineNo插入行号:从1开始,指定在文件的第几行插入内容。不指定则覆盖整个文件
json_idsYesJSON ID列表:要导出的JSON的ID数组。使用item_operations工具查看可用的JSON ID
pretty_printNo是否美化输出:true(格式化缩进)、false(紧凑格式)

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It discloses some behavioral traits like automatic directory creation and support for absolute/relative paths, but it doesn't cover critical aspects such as whether this is a destructive operation (e.g., file overwriting), error handling, permissions needed, or rate limits. For a write operation with zero annotation coverage, this is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized with two sentences that are front-loaded and efficient. Every sentence adds value: the first states the core purpose and key features, and the second provides practical details on path handling and directory creation, with zero waste.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity (a write operation with 5 parameters, no annotations, and no output schema), the description is incomplete. It lacks information on behavioral aspects like destructiveness, error handling, and output format details. Without annotations or an output schema, the description should do more to compensate, but it falls short, leaving gaps for a tool that modifies files.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all parameters thoroughly. The description adds minimal value beyond the schema by mentioning '支持多种格式和插入位置' (supports multiple formats and insertion positions), which loosely relates to 'format' and 'insert_line' parameters, but doesn't provide additional syntax or meaning. Baseline 3 is appropriate when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb ('导出' meaning export) and resource ('JSON数据' meaning JSON data) to a file, specifying the action and target. It distinguishes from siblings by focusing on file export rather than JSON generation (batch_generate_json) or item operations (item_operations). However, it doesn't explicitly mention that it's for writing/creating files, which could be slightly more specific.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage by mentioning support for multiple formats and insertion positions, and it references item_operations for viewing JSON IDs, providing some context. However, it lacks explicit guidance on when to use this tool versus alternatives (e.g., batch_generate_json for creating JSON vs. exporting existing JSON), and no exclusions or prerequisites are stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

item_operationsJSON/模板操作C

通用工具,用于创建、获取、列表、编辑、删除JSON或模板,以及获取统计信息。支持完整的CRUD操作和高级查询功能。

ParametersJSON Schema
NameRequiredDescriptionDefault
actionYes操作类型:create(创建)、get(获取)、list(列表)、edit(编辑)、delete(删除)、stats(统计)
categoryNo分类:模板的分类,如'user'、'product'、'config'等
contentNo内容:JSON字符串,必须是有效的JSON格式。示例:{"key":"value"}
descriptionNo描述:项目的详细说明,帮助理解项目用途
filter_tagsNo标签筛选:只显示包含指定标签的JSON,如['user', 'active']
filter_typeNo类型筛选:all(全部)、generated(批量生成)、manual(手动创建)
idNo项目ID:用于get、edit、delete操作,必须是已存在的ID
indexNo数组索引:add/remove操作时的位置索引,从0开始。不指定则添加到末尾或删除第一个
item_typeNo项目类型:json(JSON数据) 或 template(模板),除stats外都需要指定
limitNo列表限制:返回的最大项目数量,默认20,最大100
nameNo名称:创建时的项目名称,建议使用有意义的描述性名称
operationNo编辑操作:set(设置值)、add(添加元素)、remove(删除)、update(更新对象)
pathNo节点路径:编辑JSON时的路径,支持点号分隔。示例:'users.0.name'、'config.database.host'
sort_byNo排序方式:createdAt(创建时间)、updatedAt(更新时间)、name(名称)、size(大小)
tagsNo标签:JSON项目的分类标签,如['user', 'config', 'test']
valueNo新值:要设置、添加或更新的值。可以是任何类型:字符串、数字、数组、对象等
variablesNo变量:模板中的变量名列表,如['name', 'age', 'email']

TDQS

C2.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions 'CRUD operations' and 'advanced query', but fails to describe critical behaviors like authentication needs, rate limits, error handling, or what 'stats' returns. For a tool with 17 parameters and multiple actions, this leaves significant gaps in understanding how it behaves.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that efficiently lists capabilities ('create, get, list, edit, delete, stats') and mentions 'CRUD operations and advanced query'. However, it's front-loaded with a broad claim ('通用工具') and could be more structured to highlight key use cases or differentiate from siblings, making it adequate but not optimally concise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's high complexity (17 parameters, 6 actions), no annotations, and no output schema, the description is insufficient. It doesn't explain return values, error conditions, or behavioral nuances like how 'edit' with 'operation' works. The agent must rely heavily on the input schema, leaving gaps in understanding the tool's full context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, so the schema already documents all 17 parameters thoroughly with descriptions and enums. The description adds no additional parameter semantics beyond what's in the schema, such as explaining dependencies between parameters (e.g., 'id' is required for 'get' but not 'create'). Baseline 3 is appropriate when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the tool performs 'CRUD operations and advanced query functions' on 'JSON or templates', which gives a general purpose. However, it's vague about what specific resources it operates on ('JSON or templates' is broad) and doesn't distinguish from sibling tools like 'batch_generate_json' or 'export_to_file'—it's unclear when to use this versus those alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus its siblings ('batch_generate_json', 'export_to_file'). The description mentions 'advanced query function' but doesn't specify contexts or exclusions, leaving the agent to infer usage from the parameter schema alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 3 tool updatesv1.0.0
    • First observedbatch_generate_json
    • First observedexport_to_file
    • First observeditem_operations

TDQS

C2.9/5.0
Disambiguation3/5

The tools have distinct primary purposes—batch generation, file export, and CRUD operations—but 'item_operations' is overly broad and could overlap with the others, especially since it handles JSON/template CRUD which might include generation or export-like functions. Descriptions help clarify, but the boundaries are somewhat fuzzy.

Naming Consistency3/5

The naming is mixed: 'batch_generate_json' and 'export_to_file' follow a verb_noun pattern, but 'item_operations' uses a vague noun-based style. This inconsistency makes the set less predictable, though the names are still readable and not chaotic.

Tool Count4/5

With 3 tools, the count is reasonable for a JSON-focused server, though it feels slightly thin for covering all aspects of JSON manipulation. Each tool appears to serve a distinct role, so it's well-scoped but could benefit from more granularity in some areas.

Completeness4/5

The tools cover key areas: generation, export, and CRUD operations, providing good lifecycle coverage for JSON data. However, there are minor gaps, such as no dedicated tool for JSON validation or transformation, which agents might need to work around using the existing tools.

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides powerful JSON manipulation tools through Model Context Protocol, enabling complex queries, schema generation, and validation with jq notation and native Node.js operations.
    18
    ISC
  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables users to manage data in a simple JSON file database through MCP tools and REST API. Supports creating, reading, updating, and deleting items organized in collections with auto-generated UUIDs.
    -

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/zb2947244682/mcp-json-maker'

If you have feedback or need assistance with the MCP directory API, please join our Discord server