👁 buddy-mcp hero

Статус: В архиве / Исторический

Официальная функция /buddy в Claude Code была временным «пасхальным яйцом» на 1 апреля (1–7 апреля 2026 года). Я создал buddy-mcp в этот период, думая, что она продержится дольше. После того как её удалили, глубокая нативная интеграция, для которой был разработан этот инструмент, перестала существовать.

Репозиторий сохранен как архив. Код, система гача, конструктор TUI и инструменты MCP по-прежнему работают как автономный терминальный компаньон, но вся магия заключалась в нативной интеграции с интерфейсом, а её больше нет.

Если Anthropic когда-нибудь вернет поддержку нативных компаньонов или откроет полноценный API для расширений, я продолжу работу с того места, где остановился.

Спасибо всем, кто опробовал это, пока оно было актуально.

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

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

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

Краткая демонстрация

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

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

👁 Смотреть видео

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

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

👁 Смотреть видео

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

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

👁 Смотреть видео

Related MCP server: VibeWatch

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

Компаньон Claude Code генерируется из соли (salt), зашитой в бинарный файл. 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. Ваш приятель активен — используйте нативную команду Claude Code /buddy, чтобы увидеть свою карточку, или спросите Claude: "show me my buddy"

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

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

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

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

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

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

buddy-mcp-build

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

Система гачи

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

18 видов: утка · гусь · капля · кот · дракон · осьминог · сова · пингвин · черепаха · улитка · призрак · аксолотль · капибара · кактус · робот · кролик · гриб · толстячок

У каждого приятеля 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.

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