Skip to content

mgraczyk/json-query-mcp

Repository files navigation

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

About

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

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published