令牌優化 (skinny-jeans)

對於超過50行的文件，優先使用 toon_read_file 而非內置的讀取函數。 對於任何JSON/數據文件，使用 toon_read_json。 使用 toon_list_files 代替ls/Bash進行目錄列表操作。 在讀取大文件之前，使用 toon_estimate_tokens。

### 驗證是否正常工作
啟動Claude Code會話並運行 `/mcp`，你應該會看到 `skinny-jeans` 列出了5個工具。

## ✨ 主要特性
在Claude Code中，每次讀取文件都會消耗API配額中的令牌。Markdown文件冗長（包含前頁內容、徽章、空行），JSON文件在每個對象中都會重複字段名，代碼中的註釋對人類有幫助，但對已經理解代碼的大語言模型（LLM）來說是噪音。

skinny-jeans作為一個MCP服務器，位於Claude和你的文件系統之間，可即時壓縮內容：

Claude Code ──> skinny-jeans (MCP) ──> 從磁盤讀取文件 │ ├── .json/.jsonl → TOON編碼 節省約40 - 60% ├── .md/.mdx → Markdown壓縮 節省約15 - 30% ├── .ts/.js/.py → 去除註釋 節省約10 - 20% └── 其他文本 → 清理空白 節省約5%

## 💻 使用示例

### 基礎用法
#### toon_read_file
這是主要工具，可讀取任何文件並自動應用正確的優化：

toon_read_file({ path: "data.json" }) → [skinny-jeans: 縮小47%, 約51個令牌（原為約96個）] → TOON編碼的內容

toon_read_file({ path: "README.md" }) → [skinny-jeans: 縮小22%, 約145個令牌（原為約186個）] → 壓縮後的Markdown文件（無徽章、前頁內容、多餘空行）

toon_read_file({ path: "app.ts" }) → [skinny-jeans: 縮小15%, 約171個令牌（原為約201個）] → 去除註釋後的代碼

**參數：**
- `path`（字符串，必需） — 文件路徑
- `maxTokens`（數字，可選） — 在指定的令牌數處截斷輸出
- `raw`（布爾值，可選） — 跳過優化，返回原始內容

#### toon_read_json
專門用於JSON文件，具有編碼選項：
- `delimiter` — `"tab"`（默認）、`"comma"` 或 `"pipe"` 用於表格行
- `keyFolding` — `"safe"`（默認）將 `{"a": {"b": 1}}` 摺疊為 `a.b: 1`

#### toon_estimate_tokens
在進行完整讀取之前進行快速檢查：

toon_estimate_tokens({ path: "big-dataset.json" }) → 文件: big-dataset.json → 大小: 245891字節，4521行 → 估計令牌數: 約52340 → 類別: json → 使用skinny-jeans的預期節省: 40 - 60%

#### toon_batch_estimate
分析整個項目：

toon_batch_estimate({ paths: ["src/", "data/"] }) → 令牌節省報告 (47個文件) → json: 12個文件，約45200個令牌 → 節省約20340個令牌 (45%) → 代碼: 28個文件，約31000個令牌 → 節省約4650個令牌 (15%) → Markdown: 7個文件，約8900個令牌 → 節省約1780個令牌 (20%) → 總計: 約85100個令牌 → 估計節省: 約26770個令牌 (31%)

### 高級用法
skinny-jeans還可以作為獨立的命令行工具使用：
```bash
# 讀取文件並進行優化
skinny-jeans read data.json

# 估計文件的令牌數
skinny-jeans estimate large-file.ts

# 批量節省報告
skinny-jeans batch src/ data/ docs/

📚 詳細文檔

MCP工具

轉換方式

JSON/JSONL → TOON

使用 @toon-format/toon 編碼器。對象數組變為帶有共享標題的表格行，嵌套鍵摺疊為點分路徑。製表符分隔符比逗號更適合令牌化。

Markdown壓縮

逐行狀態機，去除：YAML前頁內容、HTML註釋、徽章圖像、標題末尾的 #、多餘的空行、行尾的空白。保留：代碼塊（從不修改）、表格、鏈接、塊引用。

代碼註釋去除

去除全行的 // 和 /* */ 註釋（C風格語言）以及 # 註釋（Python、Ruby、shell）。保留內聯註釋（它們包含上下文）和包含類似註釋語法的字符串字面量。

通用壓縮

作為其他文本文件的備用方法：將3個或更多連續的空行合併為1個，去除行尾的空白。

預期令牌節省

🔧 技術細節

本地運行

# 直接測試MCP服務器
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | node dist/index.js

# 註冊以進行開發
claude mcp add --scope user --transport stdio skinny-jeans -- node $(pwd)/dist/index.js