json-mcp-lite
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:
Tool | What it does |
| List records, with |
| Keyword search; every word must match, case-insensitive |
| 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 testRelated MCP server: Simple MCP Server
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 skuThen ask: "Which teas are under ₹400 and in stock?" or "Show me product MUG-001."
Options
Flag | Default | Meaning |
| (required) | The JSON file |
| root | Dot path to the array inside the file, e.g. |
|
| Tool name prefix: |
|
| Field used by |
| all fields | Comma-separated fields that |
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/toolsendpointsSeveral 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).
Available Tools
3 toolsproducts_getGet one products recordARead-only
Fetch a single record from products (5 records; fields: sku, title, description, price, stock) by sku.
Inputs: sku (required).
products_listList productsARead-only
List records from products (5 records; fields: sku, title, description, price, stock). Paginate with limit/offset.
Inputs: limit, offset.
products_searchSearch productsARead-only
Keyword search over title, description in products (5 records; fields: sku, title, description, price, stock). All words must match (case-insensitive).
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
products_list retrieves all records, products_search performs keyword matching, and products_get fetches by primary key. Each tool has a clearly distinct action and return shape, leaving no ambiguity about which to call for a given need.
All three tools follow the same noun_verb pattern: products_list, products_search, products_get. The convention is applied uniformly with no deviations in casing or verb style.
Three tools is a tight, well-scoped surface for a lite JSON data server exposing a single products collection. Each tool earns its place, covering the fundamental read patterns without redundancy.
The read surface is complete for retrieving data: full listing with pagination, keyword search, and single-record lookup by sku. Write operations are absent, but the 'lite' designation implies a read-only toolset, so this is a minor rather than critical gap.
Maintenance
Related MCP Connectors
An MCP server for search and retrieval over a local LanceDB database
Marketo MCP server for AI. 130 tools to operate Marketo from Claude, Cursor, or ChatGPT.
Remote MCP: JSON repair, JSON Schema validation, JSON to TypeScript, CSV to JSON and JSON to CSV.
Remote MCP server that gives Claude, ChatGPT, Cursor or any MCP client Google search volume, CPC, competition and similar keywords for 50+ countries. Works with no signup at 20 lookups a day; sign in with OAuth or an API key for higher limits, or $4.99 a month for unlimited.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Machine Context Protocol server that enables Claude AI to interact with tools through a structured communication interface, following standard MCP patterns with server initialization and stdio transport.2,530 npm2MIT
- AlicenseBqualityDmaintenanceEnables AI tools to query context from a local JSON data source via stdio, demonstrating the Model Context Protocol.28MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for reading and listing JSON documents, designed to be used with Claude Haiku and Headroom compression to reduce token usage. It demonstrates an end-to-end MCP tool-use loop with stdio transport.-
- AlicenseNot gradedqualityCmaintenanceZero-dependency MCP server and CLI for token-efficient inspection of local CSV/JSON/JSONL files, providing schema, samples, and paginated filtered queries to AI agents.MIT