TOON MCP 서버는 OpenClaw에서 도구 결과 토큰을 30-60% 감소시킵니다.

구조화된 JSON 도구 결과를 자동으로 TOON 형식으로 압축하는 MCP 서버가 출시되었습니다. TOON은 OpenClaw 세션에서 표 형식 데이터의 토큰 사용량을 30-60% 줄이도록 설계된 토큰 효율적인 표현 형식입니다.

작동 방식

TOON은 토큰 효율적인 LLM 데이터 표현을 위해 설계된 형식으로, 필드 이름을 한 번만 선언하고, 중괄호 대신 들여쓰기를 사용하며, 불필요한 따옴표를 제거합니다. MCP 서버는 TOON과 압축 JSON 간의 토큰 수를 비교하여 더 작은 쪽을 반환합니다.

설정

OpenClaw 설정 파일(~/.openclaw/openclaw.json)에 MCP 서버를 추가하세요:

{
  "mcpServers": {
    "toon": {
      "command": "npx",
      "args": ["@fiialkod/toon-mcp-server"]
    }
  }
}

AGENTS.md에 규칙을 추가하세요: 어떤 도구라도 구조화된 JSON 데이터(객체 배열, API 응답, 데이터베이스 결과, 로그)를 반환할 때 약 20개 이상의 필드가 포함된 경우, 해당 결과를 추론하기 전에 toon_format_response 도구를 통해 전달하세요.

성능

표 형식 데이터(균일한 객체 배열, 이메일, 캘린더 이벤트, 검색 결과, 로그, DB 행)의 경우 TOON이 일반적으로 30-60% 더 효율적입니다. 작은 페이로드나 깊게 중첩된 구성의 경우 JSON 압축 형식으로 대체됩니다.

15개의 금융 거래와 15개의 질문으로 벤치마크 수행:

• JSON: 14/15 정답 (93.3%), 약 749 토큰 사용
• TOON: 14/15 정답 (93.3%), 약 398 토큰 사용

동일한 정확도로 47% 적은 토큰 사용. 오류는 서로 다른 질문에서 발생했으며 형식으로 인한 오류는 없었습니다. TOON은 테스트에서 무손실이었습니다 — decode(encode(data)) === data.

사용 사례

최적 용도: Gmail/캘린더 MCP 결과, 데이터베이스 쿼리, API 응답, 파일 목록, 로그 — 반복되는 키가 있는 객체 배열 형태의 모든 데이터.

불필요한 경우: 작은 페이로드(<5개 항목), 깊게 중첩된 구성, 원시 JSON으로 다시 전달해야 하는 데이터.

해결하는 문제

OpenClaw에서 시스템 프롬프트와 도구 스키마는 고정 비용이 높고, 작업 공간 파일은 반고정적이지만, 도구 결과는 빠르게 누적됩니다. 에이전트가 파일을 읽거나 API를 쿼리하거나 브라우징할 때, 이는 세션을 컨텍스트가 손실되는 압축 상태로 밀어넣습니다. TOON은 도구 결과가 기록에 들어가기 전에 축소함으로써 상류에서 작동하여 압축을 지연시키고 더 많은 세션 기록을 유지합니다.