Skip to main content
Glama

JSON MCP

Smithery Badge

The Model Context Protocol (MCP) server empowers LLMs to efficiently interact with JSON files. With JSON MCP, you can split, merge, and find specific data, validate within JSON files based on defined conditions.



🌟 Key Features

✅ Fast and lightweight
✅ LLM-friendly functionality


Related MCP server: mcp-server-test

🎥 Demo

Below is a demo showcasing the split functionality:

Demo: Split JSON


🔧 Use Cases (Tools)

1. split

Split a JSON file into a specified number of objects.

Note: The file path must be provided.

Prompt Example:

Split JSON file from /Users/json-mcp/tests/merged.json
5 objects per file

2. merge

Merge JSON files into a one JSON file

Note: The folder path should be provided

Prompt Example:

Merge json files from /Users/json-mcp/tests

⚙️ Configuration

VS Code Manual Configuration

To configure the JSON MCP server manually in VS Code, update the User Settings (JSON) file:

{
  "mcp": {
    "servers": {
      "json-mcp-server": {
        "command": "npx",
        "args": ["json-mcp-server@latest"]
      }
    }
  }
}

Installation in VS Code

You can install the JSON MCP server using the VS Code CLI:

# For VS Code
code --add-mcp '{"name":"json-mcp-server","command":"npx","args": ["json-mcp-server@latest"]}'

After installation, the JSON MCP server will be available for use with your GitHub Copilot agent in VS Code.

Claude Desktop

To install json-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @VadimNastoyashchy/json-mcp --client claude

⚙️ Installation Server

Install globally

npm install -g json-mcp-server@latest

Run after global installation

json-mcp-server
npx json-mcp-server@latest

Available Tools

2 tools
mergeC

Merge JSON files into a one JSON file

Inputs: path (required).

splitB

Split a JSON file into a specified number of objects

Inputs: path (required), numObjects (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 2 tools

    Disambiguation5/5

    Merge and split are clearly opposite operations. An agent can easily distinguish their purposes without ambiguity.

    Naming Consistency5/5

    Both tools use concise, single-word verbs (merge, split) following a consistent pattern.

    Tool Count4/5

    Two tools is slightly below the typical well-scoped range, but the server's narrow focus on merge/split operations justifies this minimal set.

    Completeness4/5

    The server covers the core merge and split operations for JSON files. Minor gaps like transform or validate exist, but the surface is complete for its stated purpose.

    Related MCP Connectors

    Related MCP Servers