mgraczyk/json-query-mcp

11 stars 4 forks Quality 42 Trend 8

An MCP server that gives AI agents tools to query large JSON files

Overview

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. - Query JSON files using JSONPath expressions - Search for keys similar to a query string - Search for values similar to a query string 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. Add the following to your cursor mcp json (on macOS this is /Users/$USER/.cursor/mcp.json)

README

JSON Query MCP

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.

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": [],
    },
  }
}

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

View the full README on GitHub

Install

npx <local path to this repo>

New to MCP? Start with the mcpskill.org guide →

Configuration

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