optiflow-mcp

Ein einzelnes Claude Code-Plugin, ein MCP-Server, ein Repository — kein Wrapper um separat installierte Tools. Es vereint tatsächlich die echten Quellen zweier Upstream-Projekte in seiner eigenen Codebasis:

1. Die 76 echten smart_*/Analytics/Dashboard-Monitoring-MCP-Tools von token-optimizer-mcp sowie deren PreToolUse/PreCompact-Erzwingungs-Hooks, direkt portiert nach src/optimizer/ — keine npx-Installation, kein separater Prozess.

2. Der eigentliche Rust-Komprimierungskern (SmartCrusher) von headroom wurde in native/headroom-core/ abgespalten, funktional reduziert und zu echtem WebAssembly (native/headroom-wasm/) kompiliert, das direkt vom Node-Plugin geladen wird — der echte Rust-Algorithmus, keine Neuimplementierung. headrooms CodeCompressor und Kompress-ML-Modell wurden stattdessen nativ in TypeScript neu implementiert (src/native/).

3. Fünf eigene Module, die keines der beiden Upstream-Tools abdeckt: Bash/CLI-Ausgabe-Interception im Chop-Stil, Sitzungsbericht-Transkriptanalysen, ein Statuszeilen-Kontextmeter, /optiflow:compact-continue-Sitzungsübergabe-Checkpoints und TOON-Konvertierung für große JSON/CSV/YAML-Payloads.

Beide Upstream-Projekte werden weiterhin als Git-Submodule unter vendor/ für Herkunft/Lizenztexte referenziert, aber nichts unter src/ oder native/ importiert aus vendor/ — siehe docs/ADR/0002-real-merge-not-orchestration.md für die Begründung, warum dies das ursprüngliche Orchestrierungs-Wrapper-Design (v1) ersetzte, und docs/architecture.md für die vollständige Autoritätskarte und festgelegte Entscheidungen.

Status

Beide großen Merges sind abgeschlossen und verdrahtet: der 76-Tool- + Erzwingungs-Hook-Merge von token-optimizer-mcp und headrooms Komprimierungskern (WASM SmartCrusher + TS CodeCompressor/Kompress) werden tatsächlich von der ausgelieferten Pipeline aufgerufen, nicht nur isoliert gebaut. npm run build, npm test und npx tsc --noEmit bestehen alle — siehe docs/modules.md für modulspezifische Details und aktuelle Testanzahl. Das Bauen aus dem Quellcode benötigt eine Rust-Toolchain (rustup, das wasm32-unknown-unknown-Target, wasm-pack) zusätzlich zu Node; eine Plugin-Installation benötigt dies nicht (das kompilierte .wasm wird eingecheckt, dieselbe Begründung wie für plugin/dist/).

Related MCP server: claude-engineering-coach

Erste Schritte

Veröffentlicht unter github.com/kristijankopacevic/optiflow-mcp. End-to-End verifiziert über einen lokalen Pfad-Marketplace (dafür wird keine gh-Authentifizierung benötigt):

1. Fügen Sie in einer Claude Code-Sitzung dieses Repository als Marketplace hinzu und installieren Sie das Plugin:

   /plugin marketplace add C:\path\to\optiflow-mcp
   /plugin install optiflow@optiflow

2. Überprüfen Sie Ihre Umgebung:

   optiflow doctor

   Meldet Node/npm-Versionen, Konfigurationsauflösung und gh-Präsenz/Authentifizierung.

3. Aktivieren Sie die Statuszeile (optional, Opt-in — die alleinige Installation des Plugins berührt Ihre settings.json nicht):

   optiflow install --statusline

   Erstellt eine Sicherungskopie Ihrer ~/.claude/settings.json vor dem Schreiben, schreibt atomar und weigert sich, eine andere vorhandene Statuszeile ohne --force zu überschreiben. optiflow uninstall macht dies rückgängig. Siehe docs/statusline-manual-setup.md für Details (einschließlich manueller Einrichtung) und docs/modules.md für die übrigen Module.

Siehe docs/ für Architektur, Konfiguration und modulspezifische Referenztiefe über diesen Schnellstart hinaus.

Lizenz

MIT für den eigenen Code von optiflow-mcp (siehe LICENSE). Dieses Repository kopiert auch Quellcode von MIT-lizenzierten (token-optimizer-mcp) und Apache-2.0-lizenzierten (headroom) Upstream-Projekten — siehe THIRD_PARTY_LICENSES.md und NOTICE.