toonify-mcp 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/README.de.md +270 -0
  2. package/README.es.md +1 -1
  3. package/README.fr.md +270 -0
  4. package/README.id.md +1 -1
  5. package/README.ja.md +1 -1
  6. package/README.ko.md +270 -0
  7. package/README.md +31 -1
  8. package/README.pt.md +270 -0
  9. package/README.ru.md +270 -0
  10. package/README.vi.md +1 -1
  11. package/README.zh-CN.md +1 -1
  12. package/README.zh-TW.md +1 -1
  13. package/dist/optimizer/caching/cache-types.d.ts +34 -0
  14. package/dist/optimizer/caching/cache-types.d.ts.map +1 -1
  15. package/dist/optimizer/caching/index.d.ts +2 -0
  16. package/dist/optimizer/caching/index.d.ts.map +1 -1
  17. package/dist/optimizer/caching/index.js +2 -0
  18. package/dist/optimizer/caching/index.js.map +1 -1
  19. package/dist/optimizer/caching/lru-cache.d.ts +70 -0
  20. package/dist/optimizer/caching/lru-cache.d.ts.map +1 -0
  21. package/dist/optimizer/caching/lru-cache.js +230 -0
  22. package/dist/optimizer/caching/lru-cache.js.map +1 -0
  23. package/dist/optimizer/caching/persistent-cache.d.ts +82 -0
  24. package/dist/optimizer/caching/persistent-cache.d.ts.map +1 -0
  25. package/dist/optimizer/caching/persistent-cache.js +237 -0
  26. package/dist/optimizer/caching/persistent-cache.js.map +1 -0
  27. package/dist/optimizer/token-optimizer.d.ts +31 -1
  28. package/dist/optimizer/token-optimizer.d.ts.map +1 -1
  29. package/dist/optimizer/token-optimizer.js +100 -5
  30. package/dist/optimizer/token-optimizer.js.map +1 -1
  31. package/dist/optimizer/types.d.ts +3 -2
  32. package/dist/optimizer/types.d.ts.map +1 -1
  33. package/dist/server/mcp-server.d.ts +8 -0
  34. package/dist/server/mcp-server.d.ts.map +1 -1
  35. package/dist/server/mcp-server.js +112 -40
  36. package/dist/server/mcp-server.js.map +1 -1
  37. package/package.json +1 -1
package/README.de.md ADDED
@@ -0,0 +1,270 @@
1
+ # 🎯 Toonify MCP
2
+
3
+ **[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [한국어](README.ko.md) | [Русский](README.ru.md) | [Português](README.pt.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
4
+
5
+ MCP-Server + Claude Code Plugin zur automatischen Token-Optimierung für strukturierte Daten.
6
+ Reduziert den Claude-API-Token-Verbrauch um **30-65% je nach Datenstruktur** durch transparente TOON-Format-Konvertierung, mit typischen Einsparungen von **50-55%** für strukturierte Daten.
7
+
8
+ ## Neu in v0.3.0
9
+
10
+ ✨ **Mehrsprachige Token-Optimierung!**
11
+ - ✅ Präzise Token-Zählung für über 15 Sprachen (Chinesisch, Japanisch, Koreanisch, Spanisch, Arabisch, etc.)
12
+ - ✅ Sprachabhängige Token-Multiplikatoren (2x für Chinesisch, 2,5x für Japanisch, 3x für Arabisch)
13
+ - ✅ Unterstützung für mehrsprachige Texte mit automatischer Erkennung
14
+ - ✅ Verbesserte Optimierungsgenauigkeit basierend auf echten Benchmarks
15
+ - ✅ Datengestützte Token-Einsparungs-Angaben (30-65% Bereich, typischerweise 50-55%)
16
+
17
+ ## Funktionen
18
+
19
+ - **30-65% Token-Reduktion** (typischerweise 50-55%) für JSON, CSV, YAML-Daten
20
+ - **Mehrsprachige Unterstützung** - Präzise Token-Zählung für über 15 Sprachen
21
+ - **Vollautomatisch** - PostToolUse-Hook fängt Tool-Ergebnisse ab
22
+ - **Keine Konfiguration nötig** - Funktioniert sofort mit sinnvollen Standardwerten
23
+ - **Dual-Modus** - Funktioniert als Plugin (automatisch) oder MCP-Server (manuell)
24
+ - **Integrierte Metriken** - Verfolgt Token-Einsparungen lokal
25
+ - **Stille Rückfall-Mechanismen** - Unterbricht niemals Ihren Workflow
26
+
27
+ ## Installation
28
+
29
+ ### Option A: Claude Code Plugin (Empfohlen) ⭐
30
+
31
+ **Automatische Token-Optimierung ohne manuelle Aufrufe:**
32
+
33
+ ```bash
34
+ # 1. Global installieren
35
+ npm install -g toonify-mcp
36
+
37
+ # 2. Als Plugin hinzufügen (automatischer Modus)
38
+ claude plugin add toonify-mcp
39
+
40
+ # 3. Installation überprüfen
41
+ claude plugin list
42
+ # Sollte anzeigen: toonify-mcp ✓
43
+ ```
44
+
45
+ **Das war's!** Der PostToolUse-Hook wird nun automatisch strukturierte Daten von Read, Grep und anderen Datei-Tools abfangen und optimieren.
46
+
47
+ ### Option B: MCP-Server (Manueller Modus)
48
+
49
+ **Für explizite Kontrolle oder andere MCP-Clients:**
50
+
51
+ ```bash
52
+ # 1. Global installieren
53
+ npm install -g toonify-mcp
54
+
55
+ # 2. Als MCP-Server registrieren
56
+ claude mcp add toonify -- toonify-mcp
57
+
58
+ # 3. Überprüfen
59
+ claude mcp list
60
+ # Sollte anzeigen: toonify: toonify-mcp - ✓ Connected
61
+ ```
62
+
63
+ Dann Tools explizit aufrufen:
64
+ ```bash
65
+ claude mcp call toonify optimize_content '{"content": "..."}'
66
+ claude mcp call toonify get_stats '{}'
67
+ ```
68
+
69
+ ## Funktionsweise
70
+
71
+ ### Plugin-Modus (Automatisch)
72
+
73
+ ```
74
+ Benutzer: Liest große JSON-Datei
75
+
76
+ Claude Code ruft Read-Tool auf
77
+
78
+ PostToolUse-Hook fängt Ergebnis ab
79
+
80
+ Hook erkennt JSON, konvertiert zu TOON
81
+
82
+ Optimierter Inhalt wird an Claude-API gesendet
83
+
84
+ 50-55% typische Token-Reduktion erreicht ✨
85
+ ```
86
+
87
+ ### MCP-Server-Modus (Manuell)
88
+
89
+ ```
90
+ Benutzer: ruft explizit mcp__toonify__optimize_content auf
91
+
92
+ Inhalt wird in TOON-Format konvertiert
93
+
94
+ Gibt optimiertes Ergebnis zurück
95
+ ```
96
+
97
+ ## Konfiguration
98
+
99
+ Erstellen Sie `~/.claude/toonify-config.json` (optional):
100
+
101
+ ```json
102
+ {
103
+ "enabled": true,
104
+ "minTokensThreshold": 50,
105
+ "minSavingsThreshold": 30,
106
+ "skipToolPatterns": ["Bash", "Write", "Edit"]
107
+ }
108
+ ```
109
+
110
+ ### Optionen
111
+
112
+ - **enabled**: Automatische Optimierung aktivieren/deaktivieren (Standard: `true`)
113
+ - **minTokensThreshold**: Mindestanzahl an Token vor Optimierung (Standard: `50`)
114
+ - **minSavingsThreshold**: Erforderlicher Mindest-Einsparungsprozentsatz (Standard: `30%`)
115
+ - **skipToolPatterns**: Tools, die niemals optimiert werden (Standard: `["Bash", "Write", "Edit"]`)
116
+
117
+ ### Umgebungsvariablen
118
+
119
+ ```bash
120
+ export TOONIFY_ENABLED=true
121
+ export TOONIFY_MIN_TOKENS=50
122
+ export TOONIFY_MIN_SAVINGS=30
123
+ export TOONIFY_SKIP_TOOLS="Bash,Write"
124
+ export TOONIFY_SHOW_STATS=true # Optimierungsstatistiken in Ausgabe anzeigen
125
+ ```
126
+
127
+ ## Beispiele
128
+
129
+ ### Vor der Optimierung (142 Token)
130
+
131
+ ```json
132
+ {
133
+ "products": [
134
+ {"id": 101, "name": "Laptop Pro", "price": 1299},
135
+ {"id": 102, "name": "Magic Mouse", "price": 79}
136
+ ]
137
+ }
138
+ ```
139
+
140
+ ### Nach der Optimierung (57 Token, -60%)
141
+
142
+ ```
143
+ [TOON-JSON]
144
+ products[2]{id,name,price}:
145
+ 101,Laptop Pro,1299
146
+ 102,Magic Mouse,79
147
+ ```
148
+
149
+ **Wird automatisch im Plugin-Modus angewendet - keine manuellen Aufrufe erforderlich!**
150
+
151
+ ## Nutzungstipps
152
+
153
+ ### Wann wird die Auto-Optimierung ausgelöst?
154
+
155
+ Der PostToolUse-Hook optimiert automatisch, wenn:
156
+ - ✅ Inhalt valides JSON, CSV oder YAML ist
157
+ - ✅ Inhaltsgröße ≥ `minTokensThreshold` (Standard: 50 Token)
158
+ - ✅ Geschätzte Einsparungen ≥ `minSavingsThreshold` (Standard: 30%)
159
+ - ✅ Tool NICHT in `skipToolPatterns` ist (z.B. nicht Bash/Write/Edit)
160
+
161
+ ### Optimierungsstatistiken anzeigen
162
+
163
+ ```bash
164
+ # Im Plugin-Modus
165
+ claude mcp call toonify get_stats '{}'
166
+
167
+ # Oder überprüfen Sie die Claude Code-Ausgabe für Statistiken (wenn TOONIFY_SHOW_STATS=true)
168
+ ```
169
+
170
+ ## Fehlerbehebung
171
+
172
+ ### Hook wird nicht ausgelöst
173
+
174
+ ```bash
175
+ # 1. Überprüfen, ob Plugin installiert ist
176
+ claude plugin list | grep toonify
177
+
178
+ # 2. Konfiguration überprüfen
179
+ cat ~/.claude/toonify-config.json
180
+
181
+ # 3. Statistiken aktivieren, um Optimierungsversuche zu sehen
182
+ export TOONIFY_SHOW_STATS=true
183
+ ```
184
+
185
+ ### Optimierung wird nicht angewendet
186
+
187
+ - Überprüfen Sie `minTokensThreshold` - Inhalt könnte zu klein sein
188
+ - Überprüfen Sie `minSavingsThreshold` - Einsparungen könnten < 30% sein
189
+ - Überprüfen Sie `skipToolPatterns` - Tool könnte in Ausschlussliste sein
190
+ - Überprüfen Sie, ob Inhalt valides JSON/CSV/YAML ist
191
+
192
+ ### Leistungsprobleme
193
+
194
+ - Reduzieren Sie `minTokensThreshold` für aggressivere Optimierung
195
+ - Erhöhen Sie `minSavingsThreshold`, um marginale Optimierungen zu überspringen
196
+ - Fügen Sie bei Bedarf mehr Tools zu `skipToolPatterns` hinzu
197
+
198
+ ## Vergleich: Plugin vs. MCP-Server
199
+
200
+ | Funktion | Plugin-Modus | MCP-Server-Modus |
201
+ |---------|------------|-----------------|
202
+ | **Aktivierung** | Automatisch (PostToolUse) | Manuell (Tool aufrufen) |
203
+ | **Kompatibilität** | Nur Claude Code | Jeder MCP-Client |
204
+ | **Konfiguration** | Plugin-Konfigurationsdatei | MCP-Tools |
205
+ | **Leistung** | Kein Overhead | Aufruf-Overhead |
206
+ | **Anwendungsfall** | Täglicher Workflow | Explizite Kontrolle |
207
+
208
+ **Empfehlung**: Verwenden Sie den Plugin-Modus für automatische Optimierung. Verwenden Sie den MCP-Server-Modus für explizite Kontrolle oder andere MCP-Clients.
209
+
210
+ ## Deinstallation
211
+
212
+ ### Plugin-Modus
213
+ ```bash
214
+ claude plugin remove toonify-mcp
215
+ rm ~/.claude/toonify-config.json
216
+ ```
217
+
218
+ ### MCP-Server-Modus
219
+ ```bash
220
+ claude mcp remove toonify
221
+ ```
222
+
223
+ ### Paket
224
+ ```bash
225
+ npm uninstall -g toonify-mcp
226
+ ```
227
+
228
+ ## Links
229
+
230
+ - **GitHub**: https://github.com/kevintseng/toonify-mcp
231
+ - **Issues**: https://github.com/kevintseng/toonify-mcp/issues
232
+ - **NPM**: https://www.npmjs.com/package/toonify-mcp
233
+ - **MCP Docs**: https://code.claude.com/docs/mcp
234
+ - **TOON Format**: https://github.com/toon-format/toon
235
+
236
+ ## Mitwirken
237
+
238
+ Beiträge sind willkommen! Bitte lesen Sie [CONTRIBUTING.md](CONTRIBUTING.md) für Richtlinien.
239
+
240
+ ## Lizenz
241
+
242
+ MIT License - siehe [LICENSE](LICENSE)
243
+
244
+ ## Änderungsprotokoll
245
+
246
+ ### v0.3.0 (2025-12-26)
247
+ - ✨ **Mehrsprachige Token-Optimierung** - präzise Zählung für über 15 Sprachen
248
+ - ✨ Sprachabhängige Token-Multiplikatoren (2x Chinesisch, 2,5x Japanisch, 3x Arabisch, etc.)
249
+ - ✨ Erkennung und Optimierung mehrsprachiger Texte
250
+ - ✨ Umfassende Benchmark-Tests mit echten Statistiken
251
+ - 📊 Datengestützte Token-Einsparungs-Angaben (30-65% Bereich, typischerweise 50-55%)
252
+ - ✅ 75+ bestandene Tests, einschließlich mehrsprachiger Randfälle
253
+ - 📝 Mehrsprachige README-Versionen
254
+
255
+ ### v0.2.0 (2025-12-25)
256
+ - ✨ Claude Code Plugin-Unterstützung mit PostToolUse-Hook hinzugefügt
257
+ - ✨ Automatische Token-Optimierung (keine manuellen Aufrufe erforderlich)
258
+ - ✨ Plugin-Konfigurationssystem
259
+ - ✨ Dual-Modus: Plugin (automatisch) + MCP-Server (manuell)
260
+ - 📝 Umfassende Dokumentationsaktualisierung
261
+
262
+ ### v0.1.1 (2024-12-24)
263
+ - 🐛 Fehlerbehebungen und Verbesserungen
264
+ - 📝 Dokumentationsaktualisierungen
265
+
266
+ ### v0.1.0 (2024-12-24)
267
+ - 🎉 Erstveröffentlichung
268
+ - ✨ MCP-Server-Implementierung
269
+ - ✨ TOON-Format-Optimierung
270
+ - ✨ Integrierte Metrik-Verfolgung
package/README.es.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 🎯 Toonify MCP
2
2
 
3
- **[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
3
+ **[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [한국어](README.ko.md) | [Русский](README.ru.md) | [Português](README.pt.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
4
4
 
5
5
  Servidor MCP + Plugin de Claude Code que proporciona optimización automática de tokens para datos estructurados.
6
6
  Reduce el uso de tokens de la API de Claude en **30-65% según la estructura de datos** mediante conversión transparente al formato TOON, con ahorros típicos del **50-55%** para datos estructurados.
package/README.fr.md ADDED
@@ -0,0 +1,270 @@
1
+ # 🎯 Toonify MCP
2
+
3
+ **[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [한국어](README.ko.md) | [Русский](README.ru.md) | [Português](README.pt.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
4
+
5
+ Serveur MCP + Plugin Claude Code offrant une optimisation automatique des tokens pour les données structurées.
6
+ Réduit l'utilisation des tokens de l'API Claude de **30 à 65 % selon la structure des données** grâce à la conversion transparente au format TOON, avec des économies typiques de **50 à 55 %** pour les données structurées.
7
+
8
+ ## Nouveautés de la version 0.3.0
9
+
10
+ ✨ **Optimisation multilingue des tokens !**
11
+ - ✅ Comptage précis des tokens pour plus de 15 langues (chinois, japonais, coréen, espagnol, arabe, etc.)
12
+ - ✅ Multiplicateurs de tokens adaptés aux langues (2x pour le chinois, 2,5x pour le japonais, 3x pour l'arabe)
13
+ - ✅ Support des textes multilingues avec détection automatique
14
+ - ✅ Précision d'optimisation améliorée basée sur des benchmarks réels
15
+ - ✅ Revendications d'économies de tokens basées sur des données (plage de 30 à 65 %, typiquement 50 à 55 %)
16
+
17
+ ## Fonctionnalités
18
+
19
+ - **Réduction de 30 à 65 % des tokens** (typiquement 50 à 55 %) pour les données JSON, CSV, YAML
20
+ - **Support multilingue** - Comptage précis des tokens pour plus de 15 langues
21
+ - **Entièrement automatique** - Le hook PostToolUse intercepte les résultats des outils
22
+ - **Zéro configuration** - Fonctionne immédiatement avec des paramètres par défaut sensés
23
+ - **Mode double** - Fonctionne comme Plugin (auto) ou serveur MCP (manuel)
24
+ - **Métriques intégrées** - Suivez les économies de tokens localement
25
+ - **Repli silencieux** - Ne perturbe jamais votre flux de travail
26
+
27
+ ## Installation
28
+
29
+ ### Option A : Plugin Claude Code (Recommandé) ⭐
30
+
31
+ **Optimisation automatique des tokens sans appels manuels :**
32
+
33
+ ```bash
34
+ # 1. Installer globalement
35
+ npm install -g toonify-mcp
36
+
37
+ # 2. Ajouter comme plugin (mode automatique)
38
+ claude plugin add toonify-mcp
39
+
40
+ # 3. Vérifier l'installation
41
+ claude plugin list
42
+ # Devrait afficher : toonify-mcp ✓
43
+ ```
44
+
45
+ **C'est tout !** Le hook PostToolUse interceptera et optimisera automatiquement les données structurées provenant de Read, Grep et d'autres outils de fichiers.
46
+
47
+ ### Option B : Serveur MCP (Mode manuel)
48
+
49
+ **Pour un contrôle explicite ou d'autres clients MCP :**
50
+
51
+ ```bash
52
+ # 1. Installer globalement
53
+ npm install -g toonify-mcp
54
+
55
+ # 2. Enregistrer comme serveur MCP
56
+ claude mcp add toonify -- toonify-mcp
57
+
58
+ # 3. Vérifier
59
+ claude mcp list
60
+ # Devrait afficher : toonify: toonify-mcp - ✓ Connected
61
+ ```
62
+
63
+ Ensuite, appelez les outils explicitement :
64
+ ```bash
65
+ claude mcp call toonify optimize_content '{"content": "..."}'
66
+ claude mcp call toonify get_stats '{}'
67
+ ```
68
+
69
+ ## Comment ça marche
70
+
71
+ ### Mode Plugin (Automatique)
72
+
73
+ ```
74
+ Utilisateur : Lire un gros fichier JSON
75
+
76
+ Claude Code appelle l'outil Read
77
+
78
+ Le hook PostToolUse intercepte le résultat
79
+
80
+ Le hook détecte le JSON, convertit en TOON
81
+
82
+ Contenu optimisé envoyé à l'API Claude
83
+
84
+ Réduction typique de 50 à 55 % des tokens obtenue ✨
85
+ ```
86
+
87
+ ### Mode Serveur MCP (Manuel)
88
+
89
+ ```
90
+ Utilisateur : appelle explicitement mcp__toonify__optimize_content
91
+
92
+ Contenu converti au format TOON
93
+
94
+ Retourne le résultat optimisé
95
+ ```
96
+
97
+ ## Configuration
98
+
99
+ Créez `~/.claude/toonify-config.json` (optionnel) :
100
+
101
+ ```json
102
+ {
103
+ "enabled": true,
104
+ "minTokensThreshold": 50,
105
+ "minSavingsThreshold": 30,
106
+ "skipToolPatterns": ["Bash", "Write", "Edit"]
107
+ }
108
+ ```
109
+
110
+ ### Options
111
+
112
+ - **enabled** : Activer/désactiver l'optimisation automatique (par défaut : `true`)
113
+ - **minTokensThreshold** : Nombre minimum de tokens avant optimisation (par défaut : `50`)
114
+ - **minSavingsThreshold** : Pourcentage minimum d'économies requis (par défaut : `30%`)
115
+ - **skipToolPatterns** : Outils à ne jamais optimiser (par défaut : `["Bash", "Write", "Edit"]`)
116
+
117
+ ### Variables d'environnement
118
+
119
+ ```bash
120
+ export TOONIFY_ENABLED=true
121
+ export TOONIFY_MIN_TOKENS=50
122
+ export TOONIFY_MIN_SAVINGS=30
123
+ export TOONIFY_SKIP_TOOLS="Bash,Write"
124
+ export TOONIFY_SHOW_STATS=true # Afficher les statistiques d'optimisation dans la sortie
125
+ ```
126
+
127
+ ## Exemples
128
+
129
+ ### Avant optimisation (142 tokens)
130
+
131
+ ```json
132
+ {
133
+ "products": [
134
+ {"id": 101, "name": "Laptop Pro", "price": 1299},
135
+ {"id": 102, "name": "Magic Mouse", "price": 79}
136
+ ]
137
+ }
138
+ ```
139
+
140
+ ### Après optimisation (57 tokens, -60 %)
141
+
142
+ ```
143
+ [TOON-JSON]
144
+ products[2]{id,name,price}:
145
+ 101,Laptop Pro,1299
146
+ 102,Magic Mouse,79
147
+ ```
148
+
149
+ **Appliqué automatiquement en mode Plugin - aucun appel manuel nécessaire !**
150
+
151
+ ## Conseils d'utilisation
152
+
153
+ ### Quand l'optimisation automatique se déclenche-t-elle ?
154
+
155
+ Le hook PostToolUse optimise automatiquement lorsque :
156
+ - ✅ Le contenu est un JSON, CSV ou YAML valide
157
+ - ✅ La taille du contenu ≥ `minTokensThreshold` (par défaut : 50 tokens)
158
+ - ✅ Les économies estimées ≥ `minSavingsThreshold` (par défaut : 30 %)
159
+ - ✅ L'outil n'est PAS dans `skipToolPatterns` (par ex., pas Bash/Write/Edit)
160
+
161
+ ### Voir les statistiques d'optimisation
162
+
163
+ ```bash
164
+ # En mode Plugin
165
+ claude mcp call toonify get_stats '{}'
166
+
167
+ # Ou vérifier la sortie de Claude Code pour les statistiques (si TOONIFY_SHOW_STATS=true)
168
+ ```
169
+
170
+ ## Dépannage
171
+
172
+ ### Le hook ne se déclenche pas
173
+
174
+ ```bash
175
+ # 1. Vérifier que le plugin est installé
176
+ claude plugin list | grep toonify
177
+
178
+ # 2. Vérifier la configuration
179
+ cat ~/.claude/toonify-config.json
180
+
181
+ # 3. Activer les statistiques pour voir les tentatives d'optimisation
182
+ export TOONIFY_SHOW_STATS=true
183
+ ```
184
+
185
+ ### L'optimisation n'est pas appliquée
186
+
187
+ - Vérifiez `minTokensThreshold` - le contenu pourrait être trop petit
188
+ - Vérifiez `minSavingsThreshold` - les économies pourraient être < 30 %
189
+ - Vérifiez `skipToolPatterns` - l'outil pourrait être dans la liste d'exclusion
190
+ - Vérifiez que le contenu est un JSON/CSV/YAML valide
191
+
192
+ ### Problèmes de performance
193
+
194
+ - Réduisez `minTokensThreshold` pour optimiser de manière plus agressive
195
+ - Augmentez `minSavingsThreshold` pour ignorer les optimisations marginales
196
+ - Ajoutez plus d'outils à `skipToolPatterns` si nécessaire
197
+
198
+ ## Comparaison : Plugin vs Serveur MCP
199
+
200
+ | Fonctionnalité | Mode Plugin | Mode Serveur MCP |
201
+ |----------------|-------------|------------------|
202
+ | **Activation** | Automatique (PostToolUse) | Manuelle (appel d'outil) |
203
+ | **Compatibilité** | Claude Code uniquement | Tout client MCP |
204
+ | **Configuration** | Fichier de configuration du plugin | Outils MCP |
205
+ | **Performance** | Aucun surcoût | Surcoût d'appel |
206
+ | **Cas d'usage** | Flux de travail quotidien | Contrôle explicite |
207
+
208
+ **Recommandation** : Utilisez le mode Plugin pour l'optimisation automatique. Utilisez le mode Serveur MCP pour un contrôle explicite ou d'autres clients MCP.
209
+
210
+ ## Désinstallation
211
+
212
+ ### Mode Plugin
213
+ ```bash
214
+ claude plugin remove toonify-mcp
215
+ rm ~/.claude/toonify-config.json
216
+ ```
217
+
218
+ ### Mode Serveur MCP
219
+ ```bash
220
+ claude mcp remove toonify
221
+ ```
222
+
223
+ ### Package
224
+ ```bash
225
+ npm uninstall -g toonify-mcp
226
+ ```
227
+
228
+ ## Liens
229
+
230
+ - **GitHub** : https://github.com/kevintseng/toonify-mcp
231
+ - **Issues** : https://github.com/kevintseng/toonify-mcp/issues
232
+ - **NPM** : https://www.npmjs.com/package/toonify-mcp
233
+ - **Documentation MCP** : https://code.claude.com/docs/mcp
234
+ - **Format TOON** : https://github.com/toon-format/toon
235
+
236
+ ## Contribution
237
+
238
+ Les contributions sont les bienvenues ! Veuillez consulter [CONTRIBUTING.md](CONTRIBUTING.md) pour les directives.
239
+
240
+ ## Licence
241
+
242
+ Licence MIT - voir [LICENSE](LICENSE)
243
+
244
+ ## Journal des modifications
245
+
246
+ ### v0.3.0 (2025-12-26)
247
+ - ✨ **Optimisation multilingue des tokens** - comptage précis pour plus de 15 langues
248
+ - ✨ Multiplicateurs de tokens adaptés aux langues (2x chinois, 2,5x japonais, 3x arabe, etc.)
249
+ - ✨ Détection et optimisation des textes multilingues
250
+ - ✨ Tests de référence complets avec statistiques réelles
251
+ - 📊 Revendications d'économies de tokens basées sur des données (plage de 30 à 65 %, typiquement 50 à 55 %)
252
+ - ✅ Plus de 75 tests réussis, y compris les cas limites multilingues
253
+ - 📝 Versions multilingues du README
254
+
255
+ ### v0.2.0 (2025-12-25)
256
+ - ✨ Ajout du support du Plugin Claude Code avec hook PostToolUse
257
+ - ✨ Optimisation automatique des tokens (aucun appel manuel nécessaire)
258
+ - ✨ Système de configuration du plugin
259
+ - ✨ Mode double : Plugin (auto) + Serveur MCP (manuel)
260
+ - 📝 Mise à jour complète de la documentation
261
+
262
+ ### v0.1.1 (2024-12-24)
263
+ - 🐛 Corrections de bugs et améliorations
264
+ - 📝 Mises à jour de la documentation
265
+
266
+ ### v0.1.0 (2024-12-24)
267
+ - 🎉 Version initiale
268
+ - ✨ Implémentation du serveur MCP
269
+ - ✨ Optimisation au format TOON
270
+ - ✨ Suivi des métriques intégré
package/README.id.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 🎯 Toonify MCP
2
2
 
3
- **[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
3
+ **[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [한국어](README.ko.md) | [Русский](README.ru.md) | [Português](README.pt.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
4
4
 
5
5
  Server MCP + Plugin Claude Code yang menyediakan optimasi token otomatis untuk data terstruktur.
6
6
  Mengurangi penggunaan token Claude API sebesar **30-65% tergantung struktur data** melalui konversi format TOON yang transparan, dengan penghematan tipikal **50-55%** untuk data terstruktur.
package/README.ja.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 🎯 Toonify MCP
2
2
 
3
- **[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
3
+ **[English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [한국어](README.ko.md) | [Русский](README.ru.md) | [Português](README.pt.md) | [Tiếng Việt](README.vi.md) | [Bahasa Indonesia](README.id.md)**
4
4
 
5
5
  MCP サーバー + Claude Code プラグインによる構造化データの自動トークン最適化。
6
6
  透過的な TOON フォーマット変換により、**データ構造に応じて Claude API トークン使用量を 30-65% 削減**し、構造化データでは一般的に **50-55%** の節約を実現します。