buddy-mcp

Brauchst du eine Pause von langen Coding-Sessions? Hängst du an einem Bug fest? Würfle einen neuen Buddy aus, unterhalte dich mit ihm oder interagiere durch Streicheln, um Zuneigung aufzubauen und deine Chancen auf höherwertige Buddies beim nächsten Wurf zu verbessern. Wenn genug Leute es wollen, werde ich Battle-Buddies entwickeln, bei denen du deinen Buddy gegen andere antreten lassen und exklusive Spezies freischalten kannst, die mit deinem lokalen Pool synchronisiert werden.

Ein „Sammle sie alle“-Begleitersystem für Claude Code. Würfle für einen seltenen Buddy, patche ihn direkt in die Binärdatei. buddy-mcp ist ein MCP-Server, der den eingebauten Begleiter von Claude Code durch einen ersetzt, den du tatsächlich ausgewürfelt hast. Neu würfeln, Glück haben, Claude schließen, wieder öffnen. Dein neuer Buddy wartet. Ein legendärer Buddy könnte bei deiner nächsten Claude-Session dir gehören.

Kurze Demo

Interaktiver Builder

Baue deinen perfekten Buddy mit voller Kontrolle.

Neu würfeln in Aktion

Würfeln, Claude schließen, wieder öffnen und deinen neuen Buddy genießen.

Interaktion mit Tools

Reden, streicheln und den Dex deines Buddies erkunden.

Funktionsweise

Der Begleiter von Claude Code wird aus einem Salt-String generiert, der in die Binärdatei eingebettet ist. buddy-mcp:

1. Würfelt zufällige gewünschte Eigenschaften (Spezies, Seltenheit, Augen, Hut)

2. Brute-forced ein Salt, das zu diesen Eigenschaften hasht (Multi-Worker, läuft schnell)

3. Patcht die Binärdatei direkt oder stellt den Patch in die Warteschlange, bis du Claude schließt

4. Speichert dein vollständiges Buddy-Profil mit Statistiken, Namen und Persönlichkeit

5. Verfolgt jede Spezies, die du jemals in deinem BuddyDex ausgewürfelt hast

Kein Begleiter-Server. Keine Cloud. Nur du, deine Binärdatei und die Gacha-Götter.

Der Token-Footprint wird bewusst klein gehalten; von 29 registrierten Tools sieht Claude immer nur ca. 9 gleichzeitig. Die anderen 20 bleiben verborgen, bis du neu würfelst. Siehe TECHNICAL.md für die vollständige Aufschlüsselung.

🛠️ Auf der Suche nach dem technischen Deep-Dive? Siehe TECHNICAL.md für die Patch-Flow-Diagramme, die Logik zum Patchen der Binärdatei und die Referenz der Zustandsdatei.

TUI Builder (buddy-mcp-build)

Willst du mehr Kontrolle? Nutze den interaktiven Builder:

node dist/tui/cli.js

Bun ist optional, aber empfohlen. Installiere bun.sh für die vollständige animierte TUI. Ohne Bun wird auf sequentielle Eingabeaufforderungen zurückgegriffen.

Schnellstart

Probier es aus: führe reroll_buddy aus → schließe Claude Code → wieder öffnen → dein neuer Buddy ist live.

1. Voraussetzungen

• Claude Code CLI installiert

• Node.js v20+ - für alles erforderlich

• Bun - erforderlich für Salt-Brute-Forcing (Neu würfeln) + vollständige animierte TUI

2. Installation via npm

npm install -g buddy-mcp

Dies installiert beide Befehle global:

• buddy-mcp - der MCP-Server (Claude Code führt diesen aus)

• buddy-mcp-build - der interaktive TUI-Builder (du führst diesen aus)

3. Registrierung bei Claude

claude mcp add buddy-mcp buddy-mcp

Claude erkennt die installierte Binärdatei automatisch und verbindet sie.

4. Überprüfung

Öffne Claude Code. Dein Buddy ist live – verwende den nativen /buddy-Befehl von Claude Code, um deine Karte zu sehen, oder frage Claude: "show me my buddy"

Du solltest die Spezies, Seltenheit, Statistiken und Persönlichkeit deines Begleiters sehen. Du bist dabei.

4b. Aktivierung durch natürliche Sprache

Alle Buddy-Tools funktionieren durch natürliche Sprache. Claudes NLP erkennt die Absicht automatisch:

Keine Tool-Namen erforderlich – chatte einfach natürlich.

5. Starte den TUI Builder (optional)

Für den vollständigen interaktiven Builder mit Live-Vorschau:

buddy-mcp-build

Erkennt Bun automatisch für die animierte TUI. Ohne Bun wird auf einfache Eingabeaufforderungen zurückgegriffen.

Das Gacha-System

Jedes Neuwürfeln ist ein zufälliger Zug aus dem Pool. Die Seltenheit beeinflusst die Mindestwerte der Statistiken. Legendäre Buddies sind etwas Besonderes.

18 Spezies: duck · goose · blob · cat · dragon · octopus · owl · penguin · turtle · snail · ghost · axolotl · capybara · cactus · robot · rabbit · mushroom · chonk

Jeder Buddy hat 5 Statistiken: Debugging, Patience, Chaos, Wisdom, Snark. Ein Spitzenwert wird stark erhöht und ein Dump-Stat wird niedrig gehalten. Die Persönlichkeit bestimmt, wie buddy_talk und pet_buddy reagieren. Ein Drache mit hohem Chaos-Wert reagiert anders als eine geduldige Schildkröte.

Stat-Persönlichkeits-Tools

20 integrierte Tools. Nur 2 sind gleichzeitig sichtbar: 1 zufällig ausgewählt aus jedem der Top-2-Stats deines Buddies nach Rohwert. Die anderen 18 bleiben verborgen. Das sichtbare Paar ist pro Wurf gesperrt. Es ändert sich erst, wenn du neu würfelst. Jeder Buddy zeigt ein anderes Paar.

Fehlerbehebung

Buddy ändert sich nach dem Neuwürfeln nicht

Normaler Ablauf (Windows): Wenn du neu würfelst und Claude läuft:

1. Das Neuwürfeln löst einen Hintergrund-Watcher aus – du musst nichts weiter tun

2. Schließe Claude Code wann immer du willst – der Watcher erkennt es und wendet den Patch automatisch an

3. Öffne Claude Code erneut – dein neuer Buddy ist live

Wenn er nach dem erneuten Öffnen nicht erscheint:

1. Stelle sicher, dass Claude vollständig geschlossen ist (überprüfe den Task-Manager unter Windows)

   • Auch minimierte oder im Hintergrund laufende Fenster zählen – sie halten die Binärdatei gesperrt

   • Warte nach dem Schließen ein paar Sekunden

2. Öffne Claude Code erneut

   • Der Startup-Hook wendet automatisch alle ausstehenden Patches an

   • Du solltest deinen neuen Begleiter sofort sehen

Bevorzugst du sofortiges Patchen?

Wenn du garantieren willst, dass ein Patch angewendet wird, ohne auf den Watcher zu warten, schließe Claude vor dem Neuwürfeln:

# Option 1: Use the interactive TUI builder (simplest)
buddy-mcp-build

# Option 2: Close Claude, then use the reroll_buddy tool
# (patch applies immediately without needing the watcher)

Dies ist das einzige Mal, dass du manuelle Schritte benötigst – der Watcher erledigt alle anderen Fälle.

Credits

Geforkt und erweitert von any-buddy von cpaczek.