Back to Browse

Json Mcp Lite MCP Server

Developer ToolsModerate7.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Serve any JSON file as read-only list, keyword search and get-by-id MCP tools.

About

Serve any JSON file as read-only list, keyword search and get-by-id MCP tools.

Security Report

7.2
Moderate7.2Low Risk

json-mcp-lite is a well-designed, read-only MCP server with clean code and appropriate security controls. It properly validates inputs via zod, uses safe JSON parsing, and implements read-only operations with clear error handling. No authentication is required because the server operates over stdio and exposes only harmless read operations on local JSON files. Minor input validation suggestions exist but do not materially impact security. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity).

4 files analyzed · 4 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-scoretracker4321-json-mcp-lite": {
      "args": [
        "-y",
        "json-mcp-lite"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

json-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:

ToolWhat it does
<name>_listList records, with limit / offset paging
<name>_searchKeyword search; every word must match, case-insensitive
<name>_getOne 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

FlagDefaultMeaning
--file(required)The JSON file
--pathrootDot path to the array inside the file, e.g. data.items
--namerecordsTool name prefix: products → products_list, …
--ididField used by <name>_get
--searchall fieldsComma-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, /health and /tools endpoints
  • 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-liteMCP 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).

Reviews

No reviews yet

Be the first to review this server!