mcpField
J
JSON Query MCP

JSON Query MCP

Local
github.com/mgraczykDeveloper Tools11Updated 75w ago
Repository

About JSON Query MCP

JSON Query MCP is an MCP server for searching and querying large JSON files. It helps LLM-based clients retrieve targeted data using JSONPath and similarity searches.

Key features

  1. 01Query files with JSONPath
  2. 02Find keys by text similarity
  3. 03Find values by text similarity

Use cases

  1. 01Extract fields from large JSON files
  2. 02Inspect sections of a Swagger definition

MCP support

Provides MCP tools for querying large JSON files and searching keys or values.

#json-query#mcp#json-tools

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "json-query": {
      "command": "npx",
      "args": [
        "-y",
        "json-query-mcp"
      ]
    }
  }
}
Run commandnpx -y json-query-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmjson-query-mcp

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

JSON Query MCP

A Model Context Protocol (MCP) server for querying large JSON files. This server provides tools for working with large JSON data that can be used by LLM models implementing the Model Context Protocol.

Features

  • Query JSON files using JSONPath expressions
  • Search for keys similar to a query string
  • Search for values similar to a query string

Example

Here is an example of the Cursor Agent using the tool to read a a very large (>1M character) JSON Swagger definition, and extracting a small portion to write a typescript interface.

Example

Usage

npx json-query-mcp

Installation in Cursor

Add the following to your cursor mcp json (on macOS this is /Users/$USER/.cursor/mcp.json)

{
  "mcpServers": {
    ... other mcp servers
    "json-query": {
      "command": "npx",
      "args": [<local path to this repo>],
    },
  }
}

Development

# Run in development mode
npm run dev

# Run tests
npm test

# Format code
npm run format

# Lint code
npm run lint

# Fix lints
npm run fix

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.