JSON to TOON

Provides tools to convert JSON to TOON and back, analyze token savings, and support MCP client integration.

javascript

0

GitHub Stars

javascript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mhabedini-json-to-toon-mcp-server": {
      "command": "npx",
      "args": [
        "json-to-toon-mcp-server"
      ]
    }
  }
}

You can use this MCP server to convert JSON data to TOON format, convert TOON back to JSON, and analyze token savings for LLM workflows. It exposes a standard MCP interface via stdio so it can integrate with common MCP clients and tooling, enabling compact, bidirectional data transformations that save tokens in large language model interactions.

How to use

You interact with the server through an MCP client. You can run a local MCP server process and connect to it via stdio, or configure your client to launch the server as needed. Use the conversion tools to transform JSON data into the TOON format for compact data transmission, or reverse the process when you need JSON for downstream processing. You can also analyze potential token savings before performing conversions.

Typical usage patterns include starting the server in the background or on demand, then issuing tool calls such as converting JSON to TOON, converting TOON to JSON, and running a token-savings analysis. As you work, you will supply JSON data or TOON data and optional options to tailor the conversion behavior.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine.

# Install the MCP server package globally for easy access
npm install -g json-to-toon-mcp-server

If you prefer running from a local installation, you can install dependencies in your project and run the server from your project directory.

npm install
npm start

Configuration and usage notes

The MCP server is designed to run via stdio so it can connect to MCP clients that spawn and communicate with the process. You can configure the MCP client to launch the server using a command similar to npx json-to-toon-mcp-server or by pointing to a local node script for development.

Development and local running notes

For development, you may run the server with a direct node invocation pointing at the entry script. This is useful for testing changes locally before publishing to the package registry.

node index.js

TOON format benefits

TOON is designed to be token-efficient for LLM applications, often achieving 30-60% fewer tokens than JSON. It remains bidirectionally convertible with JSON and remains human readable for inspection and debugging.

Notes on features and endpoints

The server provides tools to convert JSON to TOON, convert TOON to JSON, and analyze token savings, all through the MCP interface. It runs as a local stdio service that can be integrated with any MCP client.

Security and usage cautions

Treat the MCP server like any local service exposed to developer tools. Avoid exposing sensitive data in logs or outputs and ensure you limit access to development environments where the server runs.

Troubleshooting

If the server does not start, verify Node.js and npm are installed, ensure dependencies are installed, and check that no other process is occupying the expected stdio interface. Restart the client with the server process to reestablish the MCP connection.

Available tools

convert_json_to_toon

Converts JSON data to TOON format with optional conversion options such as delimiter, indentation, and length markers.

convert_toon_to_json

Converts TOON data back to JSON, enabling round-trip data handling.

analyze_token_savings

Analyzes potential token savings when converting JSON to TOON to help you estimate benefits before performing conversions.