👁 buddy-mcp hero

상태: 아카이브됨 / 과거의 유산

공식 Claude Code /buddy 기능은 한시적인 만우절 이벤트(2026년 4월 1일~7일)였습니다. 저는 이 기능이 더 오래 지속될 것이라 생각하고 그 기간 동안 buddy-mcp를 만들었습니다. 해당 기능이 제거된 후, 이 도구가 설계되었던 깊은 네이티브 통합 기능은 더 이상 존재하지 않습니다.

이 저장소는 아카이브로 유지됩니다. 코드, 가챠 시스템, TUI 빌더, MCP 도구들은 여전히 독립적인 터미널 동반자로서 작동하지만, 이 프로젝트의 핵심이었던 네이티브 UI 통합은 사라졌습니다.

Anthropic이 향후 네이티브 동반자 지원을 다시 도입하거나 적절한 확장 API를 공개한다면, 중단했던 지점부터 다시 개발을 이어갈 것입니다.

관련 기능이 활성화되어 있을 때 관심을 가져주신 모든 분께 감사드립니다.

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

긴 코딩 세션에서 휴식이 필요하신가요? 버그 때문에 막히셨나요? 버디를 다시 뽑고, 대화하거나 쓰다듬어 애정도를 쌓아보세요. 다음 뽑기에서 더 높은 등급의 버디를 얻을 확률이 올라갑니다. 충분한 수요가 있다면, 버디를 다른 사람의 버디와 대결시키고 로컬 풀에 동기화되는 독점 종을 잠금 해제할 수 있는 '배틀 버디' 기능을 만들 예정입니다.

Claude Code를 위한 수집형 동반자 시스템입니다. 희귀 버디를 뽑아 바이너리에 직접 패치하세요. buddy-mcp는 Claude Code의 내장 동반자를 여러분이 직접 뽑은 동반자로 대체하는 MCP 서버입니다. 다시 뽑고, 운을 시험하고, Claude를 닫았다가 다시 여세요. 새로운 버디가 기다리고 있을 것입니다. 다음 Claude 세션에서 전설적인 버디를 만날지도 모릅니다.

빠른 데모

대화형 빌더

완벽한 버디를 완벽하게 제어하며 만드세요.

👁 Watch Video

다시 뽑기(Reroll)

뽑고, Claude를 닫고, 다시 열어 새로운 버디를 즐기세요.

👁 Watch Video

도구와 상호작용

대화하고, 쓰다듬고, 버디의 도감을 탐험하세요.

👁 Watch Video

Related MCP server: VibeWatch

작동 원리

Claude Code의 동반자는 바이너리에 포함된 솔트(salt) 문자열에서 생성됩니다. buddy-mcp는:

1. 무작위 특성(종, 희귀도, 눈, 모자)을 뽑습니다.

2. 해당 특성으로 해시되는 솔트를 무차별 대입(brute-force) 방식으로 찾습니다(멀티 워커 사용, 빠른 속도).

3. 바이너리를 즉시 패치하거나, Claude를 닫을 때 패치하도록 대기열에 추가합니다.

4. 능력치, 이름, 성격이 포함된 전체 버디 프로필을 저장합니다.

5. BuddyDex에서 지금까지 뽑은 모든 종을 추적합니다.

동반자 서버도, 클라우드도 없습니다. 오직 당신과 바이너리, 그리고 가챠의 신만이 있을 뿐입니다.

토큰 사용량은 의도적으로 작게 유지되며, 29개의 등록된 도구 중 Claude는 한 번에 약 9개만 인식합니다. 나머지 20개는 다시 뽑기 전까지 숨겨져 있습니다. 자세한 분석은 TECHNICAL.md를 참조하세요.

🛠️ 기술적인 심층 분석을 원하시나요? 패치 흐름 다이어그램, 바이너리 패치 로직, 상태 파일 참조는 TECHNICAL.md를 확인하세요.

TUI 빌더 (buddy-mcp-build)

더 많은 제어를 원하시나요? 대화형 빌더를 사용하세요:

node dist/tui/cli.js

Bun은 선택 사항이지만 권장됩니다. 전체 애니메이션 TUI를 보려면 bun.sh를 설치하세요. 설치하지 않으면 순차적인 프롬프트로 대체됩니다.

빠른 시작

체험하기: 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. 자연어 활성화

모든 버디 도구는 자연어를 통해 작동합니다. Claude의 NLP가 의도를 자동으로 감지합니다:

도구 이름을 외울 필요 없이 자연스럽게 대화하세요.

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가지 능력치를 가집니다: 디버깅, 인내심, 혼돈, 지혜, 비꼬기. 최고 능력치는 크게 향상되고, 가장 낮은 능력치는 낮게 유지됩니다. 성격은 buddy_talk와 pet_buddy의 반응 방식에 영향을 줍니다. 혼돈 수치가 높은 용은 인내심 많은 거북이와는 다르게 반응합니다.

능력치 성격 도구

20개의 내장 도구. 한 번에 2개만 표시됩니다: 버디의 원시 능력치 상위 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)

이 경우에만 수동 단계가 필요하며, 다른 모든 경우에는 감시자가 처리합니다.

크레딧

cpaczek의 any-buddy를 포크하여 확장했습니다.

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