Token Optimization (skinny-jeans)

50行を超えるファイルには、組み込みのReadではなくtoon_read_fileを使用します。 JSON/データファイルにはtoon_read_jsonを使用します。 ディレクトリの一覧表示にはls/Bashの代わりにtoon_list_filesを使用します。 大きなファイルを読み取る前にtoon_estimate_tokensを使用します。

### 動作確認
Claude Codeセッションを開始して`/mcp`を実行すると、`skinny-jeans`と5つのツールが表示されるはずです。

## ✨ 主な機能
Claude Codeでのファイル読み取りは、すべてAPIクォータからトークンを消費します。Markdownは冗長で（フロントマター、バッジ、空白行が多い）、JSONは各オブジェクトでフィールド名を繰り返します。コード内のコメントは人間には役立ちますが、コードを理解しているLLMにとってはノイズになります。

skinny - jeansは、Claudeとファイルシステムの間にMCPサーバーとして位置し、コンテンツをオンザフライで圧縮します。

Claude Code ──> skinny-jeans (MCP) ──> ディスクからファイルを読み取ります │ ├── .json/.jsonl → TOONエンコーディング 約40 - 60%節約 ├── .md/.mdx → Markdownの最小化 約15 - 30%節約 ├── .ts/.js/.py → コメントの削除 約10 - 20%節約 └── その他のテキスト → 空白のクリーンアップ 約5%節約

## 📦 インストール
```bash
npm install skinny-jeans

💻 使用例

基本的な使用法

toon_read_file

主なツールです。任意のファイルを読み取り、自動的に適切な最適化を適用します。

toon_read_file({ path: "data.json" })
→ [skinny-jeans: 47% smaller, ~51 tokens (was ~96)]
→ TOONエンコードされたコンテンツ

toon_read_file({ path: "README.md" })
→ [skinny-jeans: 22% smaller, ~145 tokens (was ~186)]
→ 最小化されたMarkdown（バッジ、フロントマター、余分な空白行なし）

toon_read_file({ path: "app.ts" })
→ [skinny-jeans: 15% smaller, ~171 tokens (was ~201)]
→ コメントが削除されたコード

パラメータ:

• path (文字列、必須) — ファイルパス
• maxTokens (数値、オプション) — このトークン数で出力を切り捨てます
• raw (ブール値、オプション) — 最適化をスキップし、元のコンテンツを返します

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%)

高度な使用法

toon_read_json

JSON用に特化したエンコーディングオプション付きです。

• delimiter — "tab" (デフォルト)、"comma"、または"pipe" のいずれかを指定して、表形式の行を作成します
• keyFolding — "safe" (デフォルト) は {"a": {"b": 1}} を a.b: 1 に圧縮します

📚 詳細ドキュメント

MCPツール

CLI

skinny - jeansはスタンドアロンのCLIとしても動作します。

# 最適化してファイルを読み取る
skinny-jeans read data.json

# ファイルのトークン数を推定する
skinny-jeans estimate large-file.ts

# バッチ節約レポートを生成する
skinny-jeans batch src/ data/ docs/