JSON to TOON MCP Server

JSON到TOON MCP服务器

一种模型上下文协议（MCP）服务器，提供将JSON数据转换为TOON（面向令牌的对象表示法）格式的工具。TOON是一种专为LLM应用程序设计的令牌高效格式，与JSON相比，令牌使用量减少了30-60%。

特性

• JSON到TOON的转换：使用可自定义的选项将JSON数据转换为TOON格式
• TOON到JSON转换：将TOON格式转换回JSON
• 代币节省分析：在转换之前分析潜在的代币节省
• MCP协议支持：完整的MCP服务器实现，可与LLM应用程序集成

快速开始

1.安装软件包

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

2.配置克劳德桌面

将此添加到您的 claude_desktop_config.json:

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

3.重新启动克劳德桌面

重新启动Claude Desktop，MCP服务器将可用。

安装

npm install

用法

运行服务器

npm start

服务器在stdio上运行，可以连接到任何MCP客户端。

可用工具

1. convert_json_to_toon

将JSON数据转换为TOON格式。

参数：

• json_data （string，必填）：要转换的JSON数据
• options （对象，可选）：转换选项

- delimiter （string）：表格数组的分隔符（默认值：“，”） - indentation （string）：缩进字符串（默认值：“”） - show_length_markers （boolean）：显示数组的长度标记\[N\]（默认值：true）

例子：

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

2. convert_toon_to_json

将TOON格式转换回JSON。

参数：

• toon_data （字符串，必填）：要转换的TOON数据

例子：

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

3. analyze_token_savings

分析将JSON转换为TOON时可能节省的令牌。

参数：

• json_data （string，必填）：要分析的JSON数据

例子：

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

转换示例

JSON转换为TOON

JSON输入：

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

TOON输出：

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

代币节省

与JSON相比，TOON格式通常将令牌使用量减少30-60%，这使其成为令牌效率很重要的LLM应用程序的理想选择。

发展

运行测试

npm test

发展模式

npm run dev

与MCP客户端集成

此服务器可以与任何兼容MCP的客户端集成。服务器通过stdio进行通信，使其适合与各种LLM应用程序和开发工具集成。

Claude桌面的手动配置

要手动将此MCP服务器添加到Claude Desktop，请将以下配置添加到您的 claude_desktop_config.json 文件。

配置文件位置：

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

要手动将此MCP服务器添加到Claude Desktop，请将以下配置添加到您的 claude_desktop_config.json:

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

使用本地安装的替代配置：

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

开发配置（来源）：

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

配置说明

• 替换 /path/to/json-to-toon-mcp-server 安装的实际路径
• 这 npx 该方法要求该包全局安装(npm install -g json-to-toon-mcp-server)
• 服务器通过stdio进行通信，因此不需要额外的网络配置
• 添加配置后，重新启动Claude Desktop以使更改生效

TOON格式的优点

• 代币高效：令牌比JSON少30-60%
• LLM友好：易于LLM解析的结构化格式
• 无损：JSON和TOON之间的完全双向转换
• 人类可读：在紧凑的同时保持可读性
• 模式感知：显式结构声明有助于验证

许可证

麻省理工学院