buddy-mcp

¿Necesitas un descanso de largas sesiones de código? ¿Atascado en un error? Vuelve a lanzar un amigo, habla con él o interactúa acariciándolo para aumentar el afecto y mejorar tus probabilidades de obtener amigos de mayor nivel en el próximo lanzamiento. Si hay suficiente gente interesada, crearé Battle-Buddies donde podrás enfrentar a tu amigo contra otros y desbloquear especies exclusivas que se sincronizan de vuelta en tu grupo local.

Un sistema de compañeros para coleccionarlos todos en Claude Code. Lanza para obtener un amigo raro, parchéalo directamente en el binario. buddy-mcp es un servidor MCP que reemplaza al compañero integrado de Claude Code por uno que realmente has obtenido. Vuelve a lanzar, ten suerte, cierra Claude, vuelve a abrir. Tu nuevo amigo te está esperando. Un amigo legendario podría ser tuyo en tu próxima sesión de Claude.

Demo rápida

Constructor interactivo

Construye a tu amigo perfecto con control total.

Relanzamiento en acción

Lanza, cierra Claude, vuelve a abrir y disfruta de tu nuevo amigo.

Interactúa con herramientas

Habla, acaricia y explora el dex de tu amigo.

Cómo funciona

El compañero de Claude Code se genera a partir de una cadena de sal integrada en el binario. buddy-mcp:

1. Lanza rasgos aleatorios deseados (especie, rareza, ojos, sombrero)

2. Fuerza bruta una sal que genera un hash para esos rasgos (multi-trabajador, se ejecuta rápido)

3. Parchea el binario en su lugar, o pone en cola el parche para cuando cierres Claude

4. Guarda tu perfil completo de amigo con estadísticas, nombre y personalidad

5. Rastrea cada especie que hayas lanzado en tu BuddyDex

Sin servidor de compañeros. Sin nube. Solo tú, tu binario y los dioses del gacha.

La huella de tokens se mantiene intencionalmente pequeña con 29 herramientas registradas, Claude solo ve ~9 a la vez. Las otras 20 permanecen ocultas hasta que vuelves a lanzar. Consulta TECHNICAL.md para el desglose completo.

🛠️ ¿Buscas una inmersión técnica profunda? Consulta TECHNICAL.md para ver los diagramas de flujo de parches, la lógica de parcheo binario y la referencia del archivo de estado.

Constructor TUI (buddy-mcp-build)

¿Quieres más control? Usa el constructor interactivo:

node dist/tui/cli.js

Bun es opcional pero recomendado. Instala bun.sh para la TUI animada completa. Si no, vuelve a las indicaciones secuenciales.

Inicio rápido

Pruébame: ejecuta reroll_buddy → cierra Claude Code → vuelve a abrir → tu nuevo amigo está activo.

1. Requisitos previos

• Claude Code CLI instalado

• Node.js v20+ - requerido para todo

• Bun - requerido para la fuerza bruta de sal (relanzamiento) + TUI animada completa

2. Instalar vía npm

npm install -g buddy-mcp

Esto instala ambos comandos globalmente:

• buddy-mcp - el servidor MCP (Claude Code ejecuta esto)

• buddy-mcp-build - el constructor TUI interactivo (tú ejecutas esto)

3. Registrar con Claude

claude mcp add buddy-mcp buddy-mcp

Claude detectará automáticamente el binario instalado y lo conectará.

4. Verificar

Abre Claude Code. Tu amigo está activo: usa el comando nativo /buddy de Claude Code para ver tu tarjeta, o pregúntale a Claude: "show me my buddy"

Deberías ver la especie, rareza, estadísticas y personalidad de tu compañero. Estás dentro.

4b. Activación por lenguaje natural

Todas las herramientas de amigos funcionan a través del lenguaje natural. El NLP de Claude detecta la intención automáticamente:

No se requieren nombres de herramientas, solo chatea naturalmente.

5. Iniciar el constructor TUI (opcional)

Para el constructor interactivo completo con vista previa en vivo:

buddy-mcp-build

Detecta automáticamente Bun para la TUI animada. Si no, vuelve a las indicaciones básicas.

El sistema Gacha

Cada relanzamiento es una tirada aleatoria del grupo. La rareza afecta los mínimos de estadísticas. Los legendarios son diferentes.

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

Cada amigo tiene 5 estadísticas: Depuración, Paciencia, Caos, Sabiduría, Sarcasmo. Una estadística máxima se potencia mucho y una estadística de descarte se mantiene humilde. La personalidad da forma a cómo responden buddy_talk y pet_buddy. Un dragón con mucho Caos responde diferente a una tortuga paciente.

Herramientas de personalidad de estadísticas

20 herramientas integradas. Solo 2 son visibles a la vez: 1 elegida aleatoriamente de cada una de las 2 mejores estadísticas de tu amigo por valor bruto. Las otras 18 permanecen ocultas. El par visible está bloqueado por lanzamiento. No cambia hasta que vuelves a lanzar. Cada amigo muestra un par diferente.

Solución de problemas

El amigo no cambia después de relanzar

Flujo normal (Windows): Cuando relanzas y Claude está ejecutándose:

1. El relanzamiento activa un observador en segundo plano: no necesitas hacer nada

2. Cierra Claude Code cuando quieras: el observador lo detecta y aplica el parche automáticamente

3. Vuelve a abrir Claude Code: tu nuevo amigo está activo

Si no aparece después de volver a abrir:

1. Verifica que Claude esté completamente cerrado (revisa el Administrador de tareas en Windows)

   • Incluso las ventanas minimizadas o en segundo plano cuentan: mantienen el binario bloqueado

   • Espera unos segundos después de cerrar

2. Vuelve a abrir Claude Code

   • El gancho de inicio aplica automáticamente cualquier parche pendiente

   • Deberías ver a tu nuevo compañero inmediatamente

¿Prefieres el parcheo inmediato?

Si quieres garantizar que un parche se aplique sin esperar al observador, cierra Claude antes de relanzar:

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

Esta es la única vez que necesitas pasos manuales: el observador maneja todos los demás casos.

Créditos

Bifurcado y extendido de any-buddy por cpaczek.