JSON MCP Lite

io.github.scoretracker4321v1.0.0更新于 Oct 7, 2026

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

已验证STDIO仅桌面Files & Storage Knowledge & Memory

概览

AI 生成的概览

把本地 JSON 文件变成只读的 MCP 工具，用于列出、关键词搜索和按 id 获取记录。

功能: 这个本地 stdio 服务器读取单个 JSON 文件，并以你指定的前缀暴露三个只读工具：支持 limit 和 offset 分页的列表工具、每个词都必须匹配且不区分大小写的关键词搜索工具，以及按 id 字段返回单条记录的获取工具。你可以指定文件、文件内数组的点路径、id 字段和搜索字段。它面向目录、FAQ、价目表和文档索引等场景。
适用场景: 当你有一份小型静态 JSON 数据，希望助手无需编写代码就能浏览和搜索时使用，例如产品目录、FAQ 或文档索引。它适合通过 stdio 连接的本地桌面客户端，如 Claude Desktop、Claude Code 或 Cursor。
运行要求: 作为本地 stdio 进程运行，需要 Node.js 20 或更高版本。可通过打包的发布文件安装，或克隆仓库后运行 npm install。你必须提供 JSON 文件路径，并可选提供数组路径、工具名前缀、id 字段和搜索字段。未声明需要账户、API 密钥或环境变量。

安装前请注意

这些工具是只读的，服务器不会修改你的数据。它会读取你指定的任意 JSON 文件路径，因此只应指向你愿意让助手访问的文件。README 提到一个付费配套产品 MCP Server Kit，它与这个免费服务器是分开的。

安装

在 SourceWeft 中

打开控制台中的 JSON MCP Lite，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

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:

MIT licence. Node.js 20+. Two dependencies: the official @modelcontextprotocol/sdk and zod.

Try it

bash

git clone https://github.com/scoretracker4321/json-mcp-litecd json-mcp-lite && npm installnpm start          # serves examples/products.json on stdionpm test

git clone https://github.com/scoretracker4321/json-mcp-litecd json-mcp-lite && npm installnpm start          # serves examples/products.json on stdionpm test

Use it with Claude Desktop or Cursor

json

{  "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"      ]    }  }}

{  "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:

bash

claude mcp add products -- node /abs/path/json-mcp-lite/src/server.js --file /abs/path/products.json --name products --id sku

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, /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-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]).

来源：README.md，提交 3ddb5bc

工具

工具元数据尚未被收录。

版本历史

v1.0.0最新Oct 7, 2026

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