讓大型 Claude Code 輸出
在進入 Context 前先變小

在大型 JSON、log、stack trace、原始碼進入 context window 前先自動壓縮。結構化資料、debug 輸出與原始碼平均節省 48% token。

開源 • 本地優先 • MIT 授權

一頁看懂

快速了解 Toonify 做什麼、怎麼安裝、以及如何確認運作正常。

最適合
大型 JSON、CSV、YAML、log 輸出、測試輸出與支援的原始碼。
預設路徑
先裝外掛模式,照原本的 Claude Code 流程使用就好。
怎麼驗證
toonify-mcp setuptoonify-mcp doctortoonify-mcp status,可直接看到最近一次是被優化還是被略過。
不一定需要
短文字、小檔案,以及高度依賴原始排版的內容。

最適合大型工具輸出情境

當 context 的主要負擔來自工具輸出或原始碼(而非一般對話)時,效果最佳。

最適合

大型結構化資料

常把大 JSON、CSV、YAML、API 回應或產生出的資料讀進 Claude Code 的團隊。

也有幫助

Debug 密集工作階段

測試失敗、stack trace、編譯錯誤與重複的 lint / build 輸出,這種情境更在意可行動訊號而不是每一行重複內容。

也有幫助

程式碼密集工作階段

TypeScript、Python、Go、PHP 原始碼很多,註解與空白會吃掉不少 token 的情境。

不一定適合

小檔案或純文字任務

如果你的內容大多是短文字、小檔案,或特別依賴原始排版,通常不太會感受到明顯差異。

一眼看懂差異

同樣重點,用更少 token 帶進同一個工作流程。

優化前

142 tokens
{
  "products": [
    {
      "id": 101,
      "name": "Laptop Pro",
      "price": 1299,
      "category": "Electronics",
      "inStock": true
    },
    {
      "id": 102,
      "name": "Magic Mouse",
      "price": 79,
      "category": "Accessories",
      "inStock": false
    }
  ]
}

優化後

57 tokens (-60%)
[TOON-JSON]
products[2]{id,name,price,category,inStock}:
  101,Laptop Pro,1299,Electronics,true
  102,Magic Mouse,79,Accessories,false

✓ 外掛模式下自動套用,不需要手動呼叫工具。

先走預設路徑

外掛模式最適合大多數 Claude Code 使用者。想先快速上手,就先走這條路。

推薦:外掛模式

適合大多數 Claude Code 使用者。裝好之後,支援的大型輸出會自動處理。

# 1. 下載專案
git clone https://github.com/PCIRCLE-AI/toonify-mcp.git
cd toonify-mcp

# 2. 安裝依賴並建置
npm install
npm run build

# 3. 從本機安裝
npm install -g .

# 4. 讓 Toonify 自動處理 marketplace、安裝與更新
toonify-mcp setup

# 5. 驗證安裝
toonify-mcp doctor

如果你本機已經裝過舊版,重新執行 toonify-mcp setup 就會自動更新。

🔧

進階:MCP 伺服器模式

適合需要手動控制,或想接到其他 MCP 客戶端的情境。

# 1. 註冊為 MCP 伺服器
toonify-mcp setup mcp

# 2. 驗證
claude mcp list
# 應顯示:toonify: toonify-mcp - ✓ Connected

功能特色

安裝一次,自動運作,工作流程完全不變。

🎯

外掛模式自動套用

安裝一次後,支援的大型輸出就會在平常使用時自動處理。

toonify-mcp setup
🧭

不改變原本工作流程

重點不是多一套介面,而是在你已經使用的流程裡減少負擔。

📦

大型結構化輸出

適合大 JSON、CSV、YAML、API 回應與產生出的資料,避免上下文被 payload 撐大。

🧪

Debug 輸出壓縮

適合處理長篇測試失敗、stack trace、編譯錯誤與重複的 lint / build 輸出。

🌏

支援部分原始碼壓縮

讓支援的 TypeScript、Python、Go、PHP 檔案更輕,少掉多餘註解與空白帶來的負擔。

🔄

雙模式運作

可用外掛模式自動處理,也可用 MCP 模式手動控制。

⚖️

值得時才壓縮

只有當預估節省值得時,才會真的做壓縮。

📊

本機統計與安全回退

可查看本機活動;若優化不值得,Toonify 會直接保留原始內容。

Benchmark 摘要

放在首頁的只保留足夠判斷要不要試的資訊;細節請看 benchmark 頁與 README。

12
測試案例
48.1%
平均節省
24.5-66.3%
觀察範圍

想看細節?

需要更完整的說明時,再看 benchmark、繁中 README 與 LLM 摘要即可。

一分鐘內開始使用

先裝外掛模式,支援的大型輸出會自動處理。需要手動控制時再改用 MCP 伺服器模式。