👁 buddy-mcp hero

Estado: Archivado / Histórico

La función oficial /buddy de Claude Code fue un huevo de pascua de edición limitada por el Día de los Inocentes (1-7 de abril de 2026). Construí buddy-mcp durante ese periodo pensando que podría durar más tiempo. Después de que fuera eliminado, la integración nativa profunda para la que esta herramienta fue diseñada ya no existe.

El repositorio se mantiene como archivo. El código, el sistema gacha, el constructor TUI y las herramientas MCP siguen funcionando como un compañero de terminal independiente, pero la magia siempre fue la integración nativa de la interfaz de usuario, y eso ya no existe.

Si Anthropic vuelve a traer el soporte nativo para compañeros o abre una API de extensión adecuada, retomaré esto donde lo dejé.

Gracias a todos los que lo probaron mientras era relevante.

👁 CI
👁 npm downloads
👁 npm version
👁 Node >=20
👁 License: MIT
👁 MCP Registry
👁 buddy-mcp MCP server
👁 Socket Badge

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

Un sistema de compañeros para coleccionarlos todos en Claude Code. Lanza para obtener un compañero 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 lanzaste. Vuelve a lanzar, ten suerte, cierra Claude, vuelve a abrir. Tu nuevo compañero te está esperando. Un compañero legendario podría ser tuyo en tu próxima sesión de Claude.

Demo rápida

Constructor interactivo

Construye tu compañero perfecto con control total.

👁 Watch Video

Relanzar en acción

Lanza, cierra Claude, vuelve a abrir y disfruta de tu nuevo compañero.

👁 Watch Video

Interactuar con herramientas

Habla, acaricia y explora el dex de tu compañero.

👁 Watch Video

Related MCP server: VibeWatch

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 deseados aleatorios (especie, rareza, ojos, sombrero)

2. Fuerza bruta una sal que se convierte en esos rasgos (multi-trabajador, funciona 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 compañero 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 ver 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. Vuelve a las indicaciones secuenciales sin él.

Inicio rápido

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

1. Requisitos previos

• Claude Code CLI instalado

• Node.js v20+ - requerido para todo

• Bun - requerido para la fuerza bruta de sal (relanzar) + 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 compañero está activo: usa el comando /buddy nativo 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 compañero 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. Vuelve a las indicaciones básicas sin él.

El sistema Gacha

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

18 especies: pato · ganso · gota · gato · dragón · pulpo · búho · pingüino · tortuga · caracol · fantasma · ajolote · capibara · cactus · robot · conejo · seta · chonk

Cada compañero tiene 5 estadísticas: Depuración, Paciencia, Caos, Sabiduría, Sarcasmo. Una estadística máxima se potencia mucho y una estadística mínima 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 compañero por valor bruto. Las otras 18 permanecen ocultas. El par visible está bloqueado por lanzamiento. No cambia hasta que vuelves a lanzar. Cada compañero muestra un par diferente.

Solución de problemas

El compañero 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 compañero 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.

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• buddy_talkA
• deactivate_buddy_interactA
• export_buddy_cardA
• export_buddy_spriteA
• pet_buddyA
• reroll_buddyA
• still_pointC
• view_buddy_dexA