JSON MCP Lite

Turns a local JSON file into read-only MCP tools for listing, keyword searching and fetching records by id.

What it does

This local stdio server reads a single JSON file and exposes three read-only tools named after a prefix you choose: a list tool with limit and offset paging, a case-insensitive keyword search where every word must match, and a get tool that returns one record by its id field. You point it at the file, optionally a dot path to the array inside it, the id field and the fields to search. It is aimed at catalogues, FAQs, price lists and docs indexes.

When to use it

Use it when you have a small, static JSON dataset you want an assistant to browse and search without writing custom code, for example a product catalogue, FAQ or documentation index. It suits local desktop clients such as Claude Desktop, Claude Code or Cursor over stdio.

Requirements

Runs locally as a stdio process and needs Node.js 20 or newer. It is installed from a packaged release or by cloning the repository and running npm install. You must supply the JSON file path and optionally the array path, tool name prefix, id field and search fields. No accounts, API keys or environment variables are declared.