json-mcp-lite

json-mcp-lite

Convierte un archivo JSON en un servidor MCP con un solo comando, para que Claude Desktop, Claude Code, Cursor o cualquier cliente MCP stdio pueda explorar y buscar tus datos.

Dale un catálogo, un FAQ, una lista de precios o un índice de documentación, y crea tres herramientas de solo lectura:

Herramienta	Qué hace
<name>_list	Lista registros, con paginación limit / offset
<name>_search	Búsqueda por palabras clave; cada palabra debe coincidir, sin distinguir mayúsculas
<name>_get	Un registro por su campo id

Licencia MIT. Node.js 20+. Dos dependencias: el oficial @modelcontextprotocol/sdk y zod.

Pruébalo

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

Úsalo con Claude Desktop o 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

Luego pregunta: "¿Qué tés cuestan menos de ₹400 y están en stock?" o "Muéstrame el producto MUG-001."

Opciones

Bandera	Predeterminado	Significado
--file	(obligatorio)	El archivo JSON
--path	root	Ruta de puntos al arreglo dentro del archivo, p. ej. data.items
--name	records	Prefijo del nombre de la herramienta: products → products_list, …
--id	id	Campo usado por <name>_get
--search	todos los campos	Campos separados por comas que <name>_search busca

¿Necesitas más que un archivo JSON?

json-mcp-lite es la parte gratuita, local y de un solo archivo de MCP Server Kit ($29, pago único). El Kit añade:

• Cualquier API REST → herramientas MCP desde su especificación OpenAPI 3: una herramienta tipada por operación, autenticación inyectada desde variables de entorno, filtro de solo lectura, listas de inclusión/exclusión
• Alojamiento remoto sobre Streamable HTTP (sin estado, compatible con proxies), no solo stdio
• Autenticación por clave API y límites de tasa por clave, CORS, endpoints /health y /tools
• Varias fuentes en un solo servidor, configuradas en un archivo YAML/JSON
• Imagen Docker, un router Express para montar dentro de tu propia aplicación, y guías de despliegue

	json-mcp-lite	MCP Server Kit
Archivo JSON → listar/buscar/obtener	✅	✅
stdio (Claude Desktop, Cursor, Claude Code)	✅	✅
OpenAPI / API REST → herramientas		✅
Servidor HTTP remoto		✅
Claves API + límites de tasa		✅
Múltiples fuentes, archivo de configuración		✅
Docker + documentación de despliegue		✅
Soporte por correo electrónico		✅

Licencia

MIT. Creado por Brain Grain (support@braingrain.in).