toonify-mcp 0.3.0 → 0.3.1
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.
- package/README.de.md +270 -0
- package/README.es.md +1 -1
- package/README.fr.md +270 -0
- package/README.id.md +1 -1
- package/README.ja.md +1 -1
- package/README.ko.md +270 -0
- package/README.md +1 -1
- package/README.pt.md +270 -0
- package/README.ru.md +270 -0
- package/README.vi.md +1 -1
- package/README.zh-CN.md +1 -1
- package/README.zh-TW.md +1 -1
- 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%** の節約を実現します。
|