scoretracker4321Turn any JSON file into an MCP server in one command, for Claude Desktop, Claude Code and Cursor
Turn any JSON file (product catalogue, FAQ, price list, docs index) into an MCP server in one command. It creates three read-only tools: list with paging, keyword search, and get one record by id. Works with Claude Desktop, Claude Code, Cursor and any stdio MCP client. MIT licence, Node.js 20+, two dependencies. Need more than one JSON file? MCP Server Kit turns any OpenAPI spec into MCP tools, with HTTP transport, API keys, rate limits and Docker: https://checkout.dodopayments.com/buy/pdt_0NnmvXPBAvJBJC3NqGDJq?quantity=1
·
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 |
|---|---|
<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 testUse 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 |
|---|---|---|
--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 ([email protected]).
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
- Run the command below in your terminal.
- Restart Claude Code, then check the connection with /mcp.
- Open your client's MCP config file, usually mcp.json.
- Merge this block into it.
- Restart the client to pick up the server.
- Run the command below in your terminal.
- Reload VS Code and check the MCP section of the Extensions view.
- Open ~/.codex/config.toml.
- Append this block.
- Restart Codex to pick up the server.
claude mcp add products -- node /abs/path/json-mcp-lite/src/server.js --file /abs/path/products.json --name products --id sku --search title,description{
"mcpServers": {
"products": {
"args": [
"/abs/path/json-mcp-lite/src/server.js",
"--file",
"/abs/path/products.json",
"--name",
"products",
"--id",
"sku",
"--search",
"title,description"
],
"command": "node"
}
}
}code --add-mcp '{"name":"products","args":["/abs/path/json-mcp-lite/src/server.js","--file","/abs/path/products.json","--name","products","--id","sku","--search","title,description"],"command":"node"}'[mcp_servers.products]
command = "node"
args = ["/abs/path/json-mcp-lite/src/server.js", "--file", "/abs/path/products.json", "--name", "products", "--id", "sku", "--search", "title,description"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Install with your agent
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/json-mcp-lite to learn what the "Json Mcp Lite" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
From the project README
claude mcp add products -- node /abs/path/json-mcp-lite/src/server.js --file /abs/path/products.json --name products --id skuThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Every check passed
- Installation methodRequiredThe README documents at least one way to install or connect.15/15
- Has a READMERequiredThe repository ships documentation we could read.10/10
- Easy installA paste-ready client config (an mcpServers block) is documented.12/12
- Has a licenseThe repository declares a license.8/8
- Claimed by ownerThe maintainer proved ownership of this listing.4/4
- Verified liveNot checkableWe connected to the server and it answered a real MCP handshake.—
- Exposes toolsNot checkableThe server reports at least one tool, from its manifest or a live read.—
- Ships promptsNot checkableThe server exposes at least one prompt template.—
- Ships resourcesNot checkableThe server exposes at least one resource.—
Show this grade in your README
Paste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/json-mcp-lite)Alternatives to Json Mcp Lite
View all in Databases
The Terraform MCP Server provides seamless integration with Terraform ecosystem, enabling advanced a
A set of tools to connect to AI agents, to allow them to use Todoist on a user's behalf. Includes MC
Evidence-first AI URL intelligence agent for crawling, entity resolution, social discovery, SEO, tec
v1.0.0json-mcp-lite 1.0.0Release notes
Send this prompt to your agent to leave a review
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "json-mcp-lite" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
Related MCP Servers
The Terraform MCP Server provides seamless integration with Terraform ecosystem, enabling advanced a
Developer Tools
A set of tools to connect to AI agents, to allow them to use Todoist on a user's behalf. Includes MC
Productivity Apps
Evidence-first AI URL intelligence agent for crawling, entity resolution, social discovery, SEO, tec
Browser & Scraping
Subscribe to our newsletter
One email a week. New agents, MCP servers and skills, and what is actually getting traction.
