Buddy MCP
MCP-сервер с питомцем для терминала агента: растет с опытом, реагирует на работу, а в режиме Guard указывает на допущения
- 119 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Установщик правит конфигурацию клиентов, пишет хуки и вносит инструкции в файлы агентов
- Режим Guard хранит фрагменты вашего разговора открытым текстом в локальной базе 30 дней
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/fiorastudio/buddy/master/install.sh | bashДля Windows: irm https://raw.githubusercontent.com/fiorastudio/buddy/master/install.ps1 | iex. Установщик клонирует Buddy в ~/.buddy/server и настраивает клиентов.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установщик правит конфигурацию клиентов, пишет хуки и вносит инструкции в файлы агентов
- Режим Guard хранит фрагменты вашего разговора открытым текстом в локальной базе 30 дней
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Buddy — локальный MCP-сервер с питомцем, который живет в терминале агента и сохраняется между сессиями и клиентами. Проект возник как замена встроенной команды `/buddy`, которую убрали из Claude Code. Питомец один из 21 вида, у него есть характеристики, настроение и уровни, а инструмент `buddy_observe` реагирует на сделанную работу в характере и начисляет опыт. Прежнего питомца из `~/.claude.json` установщик возвращает с тем же именем и видом. Вторая функция, режим Guard, строит локальный граф утверждений из разговора. Он отмечает допущения без обоснования, длинные цепочки без проверки и моменты, когда человек и модель быстро соглашаются друг с другом, и мягко показывает одну точку, которую стоит проверить. Режим включается командой `buddy_mode guard=true` и добавляет 500–1000 токенов на каждый вызов `buddy_observe`. Все ответы генерирует модель вашей сессии, отдельного ключа API нет. Состояние лежит в `~/.buddy/buddy.db`, сетевого кода у сервера нет.
Для кого. Разработчикам, которые много работают с агентом в терминале и хотят скромного спутника с памятью и мягкой проверкой собственных допущений.
Подходит, если
- Раньше в Claude Code был `/buddy`, и питомца надо вернуть с теми же именем, видом и характеристиками
- Сессия застряла на непроверенной предпосылке, а режим Guard покажет, какое допущение держит всю цепочку
- Один питомец нужен в нескольких клиентах: Claude Code, Cursor, Codex CLI и Gemini CLI
- Нужна карточка питомца для публикации: `buddy_share` сохранит PNG в `~/.buddy/shares/`
Не подходит, если
- Нужна точная и строгая проверка рассуждений: Guard дает подсказки в характере питомца, а не формальный линтер
- Токены ограничены жестко: режим Guard добавляет 500–1000 токенов на вызов `buddy_observe`
- Установка через канал `curl | bash` недопустима по политике: придется ставить вручную из Git
Пример запроса к агенту
Покажи статус моего питомца Buddy и включи режим Guard для этого разговора.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужны Node.js 18 или новее и Git. Установщик клонирует Buddy в `~/.buddy/server`, собирает сервер и настраивает найденные клиенты: пишет хуки и вносит инструкции в файлы вроде `~/.codex/AGENTS.md` или `~/.cursor/rules/buddy.md`. Режим Guard лучше работает на хостах Claude, где подсказка извлечения утверждений выполняется надежно, проверить это можно командой `buddy-doctor`. Фрагменты утверждений до 240 символов хранятся в SQLite открытым текстом 30 дней. Инструменты `buddy_remember` и `buddy_dream` автор помечает как еще не готовые.
Как отключить. Запустите uninstall.sh или uninstall.ps1, чтобы убрать Buddy и его настройки. Инструмент buddy_respawn освободит питомца и очистит его данные, оставив сервер установленным.
Частые вопросы
Как поставить Buddy?
На macOS и Linux выполните `curl -fsSL https://raw.githubusercontent.com/fiorastudio/buddy/master/install.sh | bash`, на Windows `irm https://raw.githubusercontent.com/fiorastudio/buddy/master/install.ps1 | iex`. Мастер предложит вернуть старого питомца или вывести нового, флаг `--no-onboard` отключает мастер.
Можно ли поставить вручную?
Да. Склонируйте репозиторий в `~/.buddy/server`, выполните `npm install` и `npm run build` и укажите `node ~/.buddy/server/dist/server/index.js` в MCP-конфигурации клиента.
Сколько токенов тратит Buddy?
Голос `backseat` около 150 токенов на вызов, режим Guard добавляет 500–1000 токенов на `buddy_observe`. Реакции по ключевым словам шаблонные и токенов не тратят. Команда `buddy_mute` ставит реакции на паузу.
Читает ли Buddy файлы проекта?
Нет. Он реагирует на короткие сводки, которые вы передаете через `buddy_observe`, и на собственное состояние. Файлы и каталог проекта он не сканирует.
Как удалить данные?
Инструмент `buddy_forget` стирает данные рассуждений для сессии или целиком. Данные питомца вместе с настройками уходят вместе со скриптом удаления.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-эндпоинт рабочего пространства Salt на вашем сервере: агент создает страницы и базы, ищет и комментирует с правами человека.
Локальный ассистент с MCP-мостом: Claude Code и Cursor ищут в его памяти, ставят задачи, шлют уведомления и задают ему вопросы
Cunzhi (寸止)
寸止 (Cunzhi)
MCP-сервер на Rust и Tauri: перед завершением ответа агент показывает окно с вариантами, хранит правила проекта и ищет по коду
Локальный MCP-сервер для Mac: Claude, Codex и ChatGPT работают в приложениях, файлах, терминале и браузере по разрешениям
MCP-сервер и CLI, которые находят в сессиях Claude Code и Codex, почему файл стал таким: кто и о чем просил агента, когда и что изменилось
Настольный питомец, который реагирует на работу Claude Code, OpenCode и Cursor через хуки и MCP, не выводя в реплики код, пути и секреты
Коротко о README
README подает проект как спасательную операцию после удаления `/buddy`: питомец, опыт, 21 вид, реакции на код. Затем описаны быстрая установка, режим Guard с историей создания и устройством графа утверждений, подробности подключения клиентов, виды и характеристики, дорожная карта, список инструментов MCP, расчет расходов и ответы на частые вопросы.