json-mcp-lite

json-mcp-lite

Transforme um arquivo JSON em um servidor MCP com um único comando, para que Claude Desktop, Claude Code, Cursor ou qualquer cliente MCP stdio possa navegar e pesquisar seus dados.

Forneça um catálogo, um FAQ, uma lista de preços ou um índice de documentação, e ele cria três ferramentas somente leitura:

Ferramenta	O que faz
<name>_list	Lista registros, com paginação limit / offset
<name>_search	Pesquisa por palavras-chave; cada palavra deve corresponder, sem diferenciar maiúsculas de minúsculas
<name>_get	Um registro pelo seu campo de id

Licença MIT. Node.js 20+. Duas dependências: o oficial @modelcontextprotocol/sdk e zod.

Experimente

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

Use com Claude Desktop ou 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

Depois pergunte: "Quais chás custam menos de ₹400 e estão em estoque?" ou "Mostre-me o produto MUG-001."

Opções

Flag	Padrão	Significado
--file	(obrigatório)	O arquivo JSON
--path	root	Caminho de ponto para o array dentro do arquivo, ex.: data.items
--name	records	Prefixo do nome da ferramenta: products → products_list, …
--id	id	Campo usado por <name>_get
--search	todos os campos	Campos separados por vírgula que <name>_search procura

Precisa de mais do que um arquivo JSON?

json-mcp-lite é a parte gratuita, local e de arquivo único do MCP Server Kit ($29, pagamento único). O Kit adiciona:

• Qualquer API REST → ferramentas MCP a partir da especificação OpenAPI 3: uma ferramenta tipada por operação, autenticação injetada do ambiente, filtro somente leitura, listas de inclusão/exclusão
• Hospedagem remota via Streamable HTTP (sem estado, amigável a proxies), não apenas stdio
• Autenticação por chave de API e limites de taxa por chave, CORS, endpoints /health e /tools
• Várias fontes em um único servidor, configuradas em um arquivo YAML/JSON
• Imagem Docker, um roteador Express para montar dentro do seu próprio aplicativo e guias de implantação

	json-mcp-lite	MCP Server Kit
Arquivo JSON → listar/pesquisar/obter	✅	✅
stdio (Claude Desktop, Cursor, Claude Code)	✅	✅
OpenAPI / REST API → ferramentas		✅
Servidor HTTP remoto		✅
Chaves de API + limites de taxa		✅
Várias fontes, arquivo de configuração		✅
Docker + documentação de implantação		✅
Suporte por e-mail		✅

Licença

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