buddy-mcp

長時間のコーディングセッションの合間に休憩が必要ですか？バグで行き詰まっていますか？バディをリロールしたり、話しかけたり、撫でて愛情を育んだりして、次のロールでより高ランクのバディが出る確率を高めましょう。要望が多ければ、バディ同士を戦わせたり、ローカルプールに同期される限定種をアンロックしたりできる「バトルバディ」機能も実装する予定です。

Claude Codeのためのコンパニオン収集システム。レアなバディをロールして、バイナリに直接パッチを当てましょう。buddy-mcpは、Claude Codeの組み込みコンパニオンを、あなたが実際にロールしたバディに置き換えるMCPサーバーです。リロールして、運を試し、Claudeを閉じて、再起動。新しいバディが待っています。次のClaudeセッションでは伝説のバディに出会えるかもしれません。

クイックデモ

インタラクティブビルダー

完璧なバディを完全にコントロールして構築します。

リロールの実演

ロールして、Claudeを閉じ、再起動して新しいバディを楽しみましょう。

ツールとの対話

話しかけたり、撫でたり、バディの図鑑を探索したりします。

仕組み

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はオプションですが推奨されます。完全なアニメーション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つのステータス からそれぞれ1つずつランダムに選ばれます。残りの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 をフォークし、拡張したものです。