Skip to content
MCP server

json-shaper-lite

Turn key: value notes, CSV/TSV and Markdown tables into typed JSON, offline

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, Windows, macOS
Runs
Locally
Version
1.1.2
Listing updated
3 days ago

About json-shaper-lite

json-shaper-lite is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

The same input always produces the same output, because the tool is plain code with no AI in the loop. It infers types, so a table row with 9.50 and false comes out as a number and a boolean, with column names turned into snake_case keys such as in_stock.

It installs from PyPI with pip or pipx, or you can download the single json_shaper_lite.py file, which relies only on Python's standard library. It works on Windows, Mac and Linux with Python 3.10 or newer, and the same package includes a small MCP server for Cursor, Claude Desktop and other clients, with no API key.

The lite version produces flat JSON and does not flatten nested JSON in the other direction. A paid Gumroad version, from $5 on a pay-what-you-want basis, adds app log parsing and a US address splitter.

Install

Run in a terminal

claude mcp add json-shaper-lite -- uvx json-shaper-lite

Add to claude_desktop_config.json

{
  "mcpServers": {
    "json-shaper-lite": {
      "command": "uvx",
      "args": [
        "json-shaper-lite"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "json-shaper-lite": {
      "command": "uvx",
      "args": [
        "json-shaper-lite"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "json-shaper-lite": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "json-shaper-lite"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "json-shaper-lite": {
      "command": "uvx",
      "args": [
        "json-shaper-lite"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "json-shaper-lite": {
      "command": "uvx",
      "args": [
        "json-shaper-lite"
      ]
    }
  }
}

What it does

Messy notes to JSON
Reads pasted key: value lists into objects.
CSV, TSV and tables
Converts CSV, TSV and Markdown tables to arrays of typed records.
Deterministic
Plain code, so identical input gives identical JSON.
Runs locally
Files stay on your computer; no upload or key needed.
CLI and MCP
Use it from the command line or as an MCP server.
Single-file option
json_shaper_lite.py runs on the standard library alone.

Good for

  • Convert a pasted Markdown table to JSON for an API call
  • Turn meeting notes written as key: value lines into a record
  • Clean a CSV export before loading it
  • Give an assistant a deterministic converter instead of asking it to reformat data

Pricing

Open source, from $5 a month

Free lite tool is MIT-licensed; paid version from $5 (pay what you want) on Gumroad

Prices change. Check tidybytetools.github.io before you buy.

json-shaper-lite FAQ

Does it use AI?

No. The README stresses plain code, so the same text always gives the same JSON.

Does it upload my files?

No. It runs on your computer.

What does the paid version add?

App log parsing and a one-line US address splitter, from $5 on Gumroad.

Can it flatten nested JSON?

No. The free tool makes flat JSON only.

Is json-shaper-lite free?

Yes. json-shaper-lite is open source, so you can use and self-host it for free.

How do I add json-shaper-lite to Claude Code?

Run this command in your terminal: claude mcp add json-shaper-lite -- uvx json-shaper-lite

What are the best alternatives to json-shaper-lite?

The closest alternatives to json-shaper-lite are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to json-shaper-lite

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools