buddy-mcp

Нужен перерыв от долгих сессий кодинга? Застряли на баге? Сделайте реролл приятеля, пообщайтесь с ним или погладьте его, чтобы повысить уровень привязанности и увеличить шансы на получение более редких существ при следующем броске. Если будет достаточно желающих, я добавлю «Боевых приятелей» (Battle-Buddies), где вы сможете выставлять своего питомца против других и открывать эксклюзивные виды, которые синхронизируются с вашим локальным пулом.

Система компаньонов «собери их всех» для Claude Code. Выбивайте редкого приятеля, патчите его прямо в бинарный файл. buddy-mcp — это MCP-сервер, который заменяет встроенного компаньона Claude Code на того, которого вы выбили. Реролл, удача, закрытие Claude, повторный запуск. Ваш новый приятель уже ждет. Легендарный питомец может стать вашим уже в следующей сессии Claude.

Быстрая демонстрация

Интерактивный конструктор

Создайте своего идеального приятеля с полным контролем.

Реролл в действии

Бросайте кубик, закрывайте Claude, открывайте снова и наслаждайтесь новым приятелем.

Взаимодействие с инструментами

Разговаривайте, гладьте и исследуйте свой BuddyDex.

Как это работает

Компаньон Claude Code генерируется на основе соли, зашитой в бинарный файл. buddy-mcp:

1. Выбирает случайные желаемые черты (вид, редкость, глаза, головной убор)

2. Брутфорсит соль, которая при хешировании дает эти черты (использует несколько потоков, работает быстро)

3. Патчит бинарный файл на месте или ставит патч в очередь до закрытия Claude

4. Сохраняет ваш полный профиль приятеля со статистикой, именем и характером

5. Отслеживает каждый вид, который вы когда-либо выбивали, в вашем BuddyDex

Никакого сервера компаньонов. Никакого облака. Только вы, ваш бинарный файл и боги гачи.

Объем токенов намеренно ограничен 29 зарегистрированными инструментами, Claude видит только около 9 за раз. Остальные 20 остаются скрытыми до тех пор, пока вы не сделаете реролл. См. TECHNICAL.md для полного разбора.

🛠️ Ищете технические подробности? См. TECHNICAL.md для схем процесса патчинга, логики патчинга бинарных файлов и описания файла состояния.

TUI-конструктор (buddy-mcp-build)

Хотите больше контроля? Используйте интерактивный конструктор:

node dist/tui/cli.js

Bun не обязателен, но рекомендуется. Установите bun.sh для полноценного анимированного TUI. Без него используются обычные последовательные подсказки.

Быстрый старт

Попробуйте: выполните reroll_buddy → закройте Claude Code → откройте снова → ваш новый приятель готов.

1. Предварительные требования

• Установленный Claude Code CLI

• Node.js v20+ — требуется для всего

• Bun — требуется для брутфорса соли (реролла) + полноценного анимированного TUI

2. Установка через npm

npm install -g buddy-mcp

Это установит обе команды глобально:

• buddy-mcp — MCP-сервер (запускается Claude Code)

• buddy-mcp-build — интерактивный TUI-конструктор (запускаете вы)

3. Регистрация в Claude

claude mcp add buddy-mcp buddy-mcp

Claude автоматически обнаружит установленный бинарный файл и подключится к нему.

4. Проверка

Откройте Claude Code. Ваш приятель активен — используйте встроенную команду /buddy в Claude Code, чтобы увидеть свою карточку, или спросите Claude: "show me my buddy"

Вы должны увидеть вид, редкость, статистику и характер вашего компаньона. Вы в игре.

4b. Активация через естественный язык

Все инструменты для приятеля работают через естественный язык. NLP Claude автоматически определяет намерение:

Названия инструментов знать не нужно — просто общайтесь как обычно.

5. Запуск TUI-конструктора (опционально)

Для полноценного интерактивного конструктора с живым предпросмотром:

buddy-mcp-build

Автоматически определяет Bun для анимированного TUI. Без него переключается на базовые подсказки.

Система гачи

Каждый реролл — это случайный выпад из пула. Редкость влияет на минимальные значения характеристик. Легендарные существа — это нечто особенное.

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

У каждого приятеля 5 характеристик: Отладка (Debugging), Терпение (Patience), Хаос (Chaos), Мудрость (Wisdom), Сарказм (Snark). Одна топовая характеристика сильно повышена, а одна слабая — занижена. Характер определяет, как будут работать buddy_talk и pet_buddy. Дракон с высоким Хаосом ведет себя иначе, чем терпеливая черепаха.

Инструменты характера и характеристик

20 встроенных инструментов. Только 2 видны одновременно: по 1 случайно выбранному из каждой из 2 лучших характеристик вашего приятеля по значению. Остальные 18 остаются скрытыми. Видимая пара закрепляется за каждым броском. Она не меняется, пока вы не сделаете реролл. У каждого приятеля своя уникальная пара.

Устранение неполадок

Приятель не меняется после реролла

Обычный процесс (Windows): Когда вы делаете реролл и Claude запущен:

1. Реролл запускает фоновый наблюдатель — от вас не требуется никаких действий

2. Закройте Claude Code в любое время — наблюдатель обнаружит это и автоматически применит патч

3. Откройте Claude Code — ваш новый приятель готов

Если он не появился после повторного открытия:

1. Убедитесь, что Claude полностью закрыт (проверьте Диспетчер задач в Windows)

   • Даже свернутые или работающие в фоне окна считаются — они блокируют бинарный файл

   • Подождите несколько секунд после закрытия

2. Откройте Claude Code снова

   • Хук при запуске автоматически применяет все ожидающие патчи

   • Вы должны сразу увидеть своего нового компаньона

Предпочитаете немедленный патчинг?

Если вы хотите гарантировать применение патча без ожидания наблюдателя, закройте Claude перед рероллом:

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

Это единственный случай, когда требуются ручные действия — во всех остальных случаях справляется наблюдатель.

Авторы

Форк и расширение any-buddy от cpaczek.