MCP JSON Navigator

Provides intelligent JSON navigation and search to explore large JSON files efficiently within the MCP framework.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "adsdworld-mcp-json-navigator": {
      "command": "node",
      "args": [
        "C:\\\\Users\\\\YOUR_USERNAME\\\\mcp-json-navigator\\\\build\\\\index.js"
      ]
    }
  }
}

You can use the MCP JSON Navigator to explore and search large JSON files quickly by navigating with precise paths and smart, token-efficient queries. This MCP server is designed to help you save tokens, browse deeply nested data, and locate specific keys or values without loading everything into memory.

How to use

You work with an MCP client to leverage the JSON Navigator. Start by building or loading the local JSON Navigator server, then configure your MCP client to connect to it. Use it to perform fast explorations of large files and to run targeted searches for keys like phone, email, or location. Use json-explore to inspect structures and json-query to locate matching paths and values. The goal is to get precise results without flooding the model context with the full file.

Practical usage patterns you can follow:

Get an overview of a large JSON file with a low verbosity level to understand its structure.
Navigate to a specific path to inspect details deeply.
Run a search for particular keys or values to identify all matching paths and scores.
Adjust verbosity to balance detail and performance depending on file size and your needs.

How to install

Prerequisites: you need Node.js and npm (Node Package Manager) installed on your system, and git to clone the repository.

# MacOS/Linux
git clone https://github.com/Adsdworld/mcp-json-navigator && cd mcp-json-navigator && npm install && npm run build

# Windows (PowerShell or CMD)
git clone https://github.com/Adsdworld/mcp-json-navigator; cd mcp-json-navigator; npm install; npm run build

Configure your MCP client to run the local server

Add a local MCP server entry to your MCP settings to point to the built navigator. Use the following configuration to run the server on your machine.

{
  "mcpServers": {
    "json-navigator": {
      "command": "node",
      "args": ["C:\\Users\\YOUR_USERNAME\\mcp-json-navigator\\build\\index.js"]
    }
  }
}

Available tools

jsonExplore

Smart JSON exploration with adjustable verbosity to reveal structure, counts, and data previews for large JSON files.

jsonQuery

Intelligent search through keys and values using fuzzy matching and camelCase tokenization to locate relevant paths and data efficiently.