JSON MCP Lite

json-mcp-lite

只需一条命令，即可将 JSON 文件转换为 MCP 服务，让 Claude Desktop、Claude Code、Cursor 或任何 stdio MCP 客户端浏览和搜索你的数据。

提供一个目录、常见问题、价目表或文档索引，它就会创建三个只读工具：

工具	功能
<name>_list	列出记录，支持通过 limit / offset 分页
<name>_search	关键词搜索；不区分大小写，且每个词都必须匹配
<name>_get	根据 id 字段获取一条记录

MIT 许可。Node.js 20+。依赖项只有两个：官方的 @modelcontextprotocol/sdk 和 zod。

试用

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

与 Claude Desktop 或 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

然后提问："哪些茶低于 ₹400 且有库存？" 或 "显示产品 MUG-001。"

选项

标志	默认值	含义
--file	(必填)	JSON 文件
--path	root	文件中数组的点路径，例如 data.items
--name	records	工具名称前缀：products → products_list，…
--id	id	<name>_get 使用的字段
--search	所有字段	以逗号分隔的字段，供 <name>_search 搜索

需要的不只是 JSON 文件？

json-mcp-lite 是 MCP Server Kit 中免费的本地单文件部分（$29，一次性付费）。该 Kit 还提供：

• 任意 REST API → MCP 工具：根据其 OpenAPI 3 规范，为每个操作创建一个带类型的工具；从 env 注入身份验证，支持只读筛选以及包含/排除列表
• 通过 Streamable HTTP 远程托管（无状态、对代理友好），不局限于 stdio
• API 密钥身份验证和按密钥限流、CORS、/health 和 /tools 端点
• 在一个服务中配置多个数据源，通过一个 YAML/JSON 配置文件完成设置
• Docker 镜像、可挂载到你自己的应用中的 Express 路由器，以及部署指南

	json-mcp-lite	MCP Server Kit
JSON 文件 → 列出/搜索/获取	✅	✅
stdio（Claude Desktop、Cursor、Claude Code）	✅	✅
OpenAPI / REST API → 工具		✅
远程 HTTP 服务		✅
API 密钥 + 限流		✅
多个数据源、配置文件		✅
Docker + 部署文档		✅
邮件支持		✅

许可

MIT。由 Brain Grain 构建（[email protected]）。