JSON to TOON MCP Server

A Model Context Protocol (MCP) server that provides tools for converting JSON data to TOON (Token-Oriented Object Notation) format. TOON is a token-efficient format designed specifically for LLM applications, reducing token usage by 30-60% compared to JSON.

Features

• JSON to TOON Conversion: Convert JSON data to TOON format with customizable options
• TOON to JSON Conversion: Convert TOON format back to JSON
• Token Savings Analysis: Analyze potential token savings before conversion
• MCP Protocol Support: Full MCP server implementation for integration with LLM applications

Quick Start

1. Install the Package

npm install -g json-to-toon-mcp-server

2. Configure Claude Desktop

Add this to your claude_desktop_config.json:

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

3. Restart Claude Desktop

Restart Claude Desktop and the MCP server will be available.

Installation

npm install

Usage

Running the Server

npm start

The server runs on stdio and can be connected to any MCP client.

Available Tools

1. convert_json_to_toon

Converts JSON data to TOON format.

Parameters:

• json_data (string, required): JSON data to convert
• options (object, optional): Conversion options
  • delimiter (string): Delimiter for tabular arrays (default: ",")
  • indentation (string): Indentation string (default: " ")
  • show_length_markers (boolean): Show length markers [N] for arrays (default: true)

Example:

{
  "json_data": "{\"users\": [{\"id\": 1, \"name\": \"Alice\"}]}",
  "options": {
    "delimiter": ",",
    "show_length_markers": true
  }
}

2. convert_toon_to_json

Converts TOON format back to JSON.

Parameters:

• toon_data (string, required): TOON data to convert

Example:

{
  "toon_data": "users[1]{id,name}:\n  1,Alice"
}

3. analyze_token_savings

Analyzes potential token savings when converting JSON to TOON.

Parameters:

• json_data (string, required): JSON data to analyze

Example:

{
  "json_data": "{\"users\": [{\"id\": 1, \"name\": \"Alice\"}]}}"
}

Example Conversions

JSON to TOON

JSON Input:

{
  "users": [
    { "id": 1, "name": "Alice", "role": "admin" },
    { "id": 2, "name": "Bob", "role": "user" }
  ]
}

TOON Output:

users[2]{id,name,role}:
  1,Alice,admin
  2,Bob,user

Token Savings

The TOON format typically reduces token usage by 30-60% compared to JSON, making it ideal for LLM applications where token efficiency is important.

Development

Running Tests

npm test

Development Mode

npm run dev

Integration with MCP Clients

This server can be integrated with any MCP-compatible client. The server communicates via stdio, making it suitable for integration with various LLM applications and development tools.

Manual Configuration for Claude Desktop

To add this MCP server to Claude Desktop manually, add the following configuration to your claude_desktop_config.json file.

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

To add this MCP server to Claude Desktop manually, add the following configuration to your claude_desktop_config.json:

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

Alternative configuration using local installation:

{
  "mcpServers": {
    "json-to-toon": {
      "command": "node",
      "args": ["/path/to/json-to-toon-mcp-server/index.js"],
      "env": {}
    }
  }
}

Configuration for development (from source):

{
  "mcpServers": {
    "json-to-toon": {
      "command": "node",
      "args": ["index.js"],
      "cwd": "/path/to/json-to-toon-mcp-server"
    }
  }
}

Configuration Notes

• Replace /path/to/json-to-toon-mcp-server with the actual path to your installation
• The npx method requires the package to be installed globally (npm install -g json-to-toon-mcp-server)
• The server communicates via stdio, so no additional network configuration is needed
• After adding the configuration, restart Claude Desktop for changes to take effect

TOON Format Benefits

• Token Efficient: 30-60% fewer tokens than JSON
• LLM-Friendly: Structured format that's easy for LLMs to parse
• Lossless: Full bidirectional conversion between JSON and TOON
• Human Readable: Maintains readability while being compact
• Schema Aware: Explicit structure declarations help with validation

License

MIT