JSON MCP Lite MCP server
Commit Oct 13, 2026Converts any JSON file into an MCP server providing tools to list, search, and retrieve records by ID.
Also known as scoretracker4321/json-mcp-lite, json-mcp-lite
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Oct 13, 2026
- License
- MIT
What is JSON MCP Lite MCP?
JSON MCP Lite converts any JSON file into an MCP server providing tools to list, search, and retrieve records by ID.
Summary generated from the project's README
About JSON MCP Lite MCP server
JSON MCP Lite allows developers to transform any local JSON file into a functional MCP server using a single command. This tool is designed for users of stdio MCP clients like Claude Desktop, Claude Code, or Cursor, enabling these AI assistants to interact directly with structured data. By pointing the server to a specific file, you can expose your data as a set of read-only tools for browsing and querying.
The server provides three specific tools based on a name prefix you define. You can use the list tool with limit and offset paging, the search tool for case-insensitive keyword matching across specified fields, and the get tool to retrieve a single record using a designated ID field. Setup requires Node.js 20 or higher and involves configuring the command path along with flags for the file location, the name prefix, the ID field, and the search fields.
What you can do with it
- 1Query a product catalogAsk an AI client to find specific items within a price range or stock status from a JSON product list.
- 2Retrieve specific record detailsRequest the full details of a single entry using its unique identifier.
- 3Search through documentation or FAQsPerform keyword searches across specific fields in a JSON-based index or FAQ file.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablescoretracker4321/json-mcp-lite is public and reachablegithub.com/scoretracker4321/json-mcp-lite ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-13github.com/scoretracker4321/json-mcp-lite ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubjson-mcp-lite
Turn a JSON file into an MCP server in one command, so Claude Desktop, Claude Code, Cursor or any stdio MCP client can browse and search your data.
Give it a catalogue, an FAQ, a price list or a docs index, and it creates three read-only tools:
| Tool | What it does |
|---|---|
<name>_list |
List records, with limit / offset paging |
<name>_search |
Keyword search; every word must match, case-insensitive |
<name>_get |
One record by its id field |
MIT licence. Node.js 20+. Two dependencies: the official @modelcontextprotocol/sdk and zod.
Try it
git clone https://github.com/scoretracker4321/json-mcp-lite
cd json-mcp-lite && npm install
npm start # serves examples/products.json on stdio
npm test
Use it with Claude Desktop or Cursor
{
"mcpServers": {
"products": {
"command": "node",
"args": [
"/abs/path/json-mcp-lite/src/server.js",
"--file", "/abs/path/products.json",
"--name", "products",
"--id", "sku",
"--search", "title,description"
]
}
}
}
Claude Code:
claude mcp add products -- node /abs/path/json-mcp-lite/src/server.js --file /abs/path/products.json --name products --id sku
Then ask: "Which teas are under ₹400 and in stock?" or "Show me product MUG-001."
Options
| Flag | Default | Meaning |
|---|---|---|
--file |
(required) | The JSON file |
--path |
root | Dot path to the array inside the file, e.g. data.items |
--name |
records |
Tool name prefix: products → products_list, … |
--id |
id |
Field used by <name>_get |
--search |
all fields | Comma-separated fields that <name>_search looks in |
Need more than a JSON file?
json-mcp-lite is the free, local, single-file part of MCP Server Kit ($29, one-time). The Kit adds:
- Any REST API → MCP tools from its OpenAPI 3 spec: one typed tool per operation, auth injected from env, read-only filter, include/exclude lists
- Remote hosting over Streamable HTTP (stateless, proxy-friendly), not only stdio
- API-key auth and per-key rate limits, CORS,
/healthand/toolsendpoints - Several sources in one server, set up in one YAML/JSON config file
- Docker image, an Express router to mount inside your own app, and deploy guides
| json-mcp-lite | MCP Server Kit | |
|---|---|---|
| JSON file → list/search/get | ✅ | ✅ |
| stdio (Claude Desktop, Cursor, Claude Code) | ✅ | ✅ |
| OpenAPI / REST API → tools | ✅ | |
| Remote HTTP server | ✅ | |
| API keys + rate limits | ✅ | |
| Multiple sources, config file | ✅ | |
| Docker + deploy docs | ✅ | |
| Email support | ✅ |
Licence
MIT. Built by Brain Grain (support@braingrain.in).
JSON MCP Lite MCP questions
What are the system requirements?
The server requires Node.js version 20 or higher.