json-query-mcp

json-query-mcp

3
cloud_platforms

JSON Query MCP is an MCP server that allows querying large JSON files effectively using JSONPath expressions. It is designed for integration with LLM models following the Model Context Protocol, offering features like key and value search functionality within JSON data.

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