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