buddy-mcp

ステータス：アーカイブ／過去の機能

Claude Code の公式 /buddy 機能は、期間限定のエイプリルフールのイースターエッグでした（2026 年 4 月 1 日〜7 日）。この機能がもっと長く続くかもしれないと思い、その期間中に buddy-mcp を作りました。機能の削除後、このツールが想定していたネイティブ連携はなくなりました。

リポジトリはアーカイブとして保存されています。コード、ガチャシステム、TUI ビルダー、MCP ツールは、スタンドアロンのターミナルコンパニオンとして引き続き動作します。ただし、このツールの魅力は常にネイティブ UI 連携にあり、それはもうありません。

Anthropic がネイティブコンパニオンのサポートを再開するか、適切な拡張 API を公開することがあれば、作業を中断したところから再開します。

使える間に試してくださった皆さん、ありがとうございました。

---

長時間のコーディングセッションにひと休みしませんか？バグに行き詰まっていませんか？コンパニオンを引き直して話しかけたり、なでたりして親密度を上げれば、次の抽選で上位ランクのコンパニオンが出る確率を高められます。十分な要望があれば、コンパニオン同士を対戦させたり、ローカルのプールに同期される限定種をアンロックしたりできる Battle-Buddies を開発します。

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

コマンド	内容
build your own	種族、レア度、目、帽子を選ぶと、一致するソルトを総当たりで探してパッチを適用します
browse presets	厳選されたプリセットの相棒から選びます
saved buddies	保存済みの相棒プロフィールを切り替えます
current	現在の相棒情報を表示します
preview	任意の種族の ASCII アートをプレビューします
share	相棒の ASCII カードをクリップボードにコピーします
restore	利用可能な最適なバックアップからバイナリを復元します
rehatch	現在の相棒を削除して、新しく始めます

Bun は任意ですが、推奨です。フル機能のアニメーション付き TUI を利用するには、bun.shからインストールしてください。Bun がない場合は、順番に表示されるプロンプトに切り替わります。

---

クイックスタート

試してみましょう： reroll_buddy を実行 → Claude Code を終了 → 再度開くと、新しい相棒が登場します。

1. 前提条件

• Claude Code CLI がインストールされていること
• Node.js v20 以降 — すべての機能に必要です
• Bun — ソルトの総当たり（再抽選）と、フル機能のアニメーション付き TUI に必要です

2. npm でインストール

npm install -g buddy-mcp

次の 2 つのコマンドがグローバルにインストールされます。

• 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 に**「相棒を見せて」**と尋ねてください。

相棒の種族、レア度、ステータス、性格が表示されます。これで準備完了です。

4b. 自然言語での有効化

すべての相棒ツールは自然言語で使えます。Claude は意図を自動的に検出します。

自然言語	有効になるツール
「相棒を再抽選して」／「もう一度回そう」	reroll_buddy
「相棒と話して」／「相棒はどう思う？」	buddy_talk
「相棒をなでて」／「なでて」	pet_buddy
「相棒図鑑を見せて」／「コレクションを見せて」	view_buddy_dex
「相棒カードをエクスポートして」／「相棒を保存して」	export_buddy_card
「スプライトをエクスポートして」／「スプライトを保存して」	export_buddy_sprite

ツール名は不要です。自然に話しかけてください。

5. TUI ビルダーを起動（任意）

ライブプレビュー付きのフル機能の対話型ビルダーを使うには、次を実行してください。

buddy-mcp-build

Bun を自動検出して、アニメーション付き TUI を起動します。Bun がない場合は、基本的なプロンプトに切り替わります。

---

ガチャシステム

リロールするたびに、プールからランダムに抽選されます。レアリティによってステータスの最低値が決まります。レジェンダリーはひと味違います。

レアリティ	ドロップ率	ステータス最低値
コモン	60%	5
アンコモン	25%	15
レア	10%	25
エピック	4%	35
レジェンダリー	1%	50

18種類： アヒル · ガチョウ · スライム · 猫 · ドラゴン · タコ · フクロウ · ペンギン · カメ · カタツムリ · ゴースト · アホロートル · カピバラ · サボテン · ロボット · ウサギ · キノコ · チョンク

それぞれの相棒は5つのステータスを持ちます：デバッグ、忍耐、カオス、知恵、皮肉。得意ステータスは高く、苦手ステータスは控えめに設定されます。性格によって、buddy_talk と pet_buddy の応答が変わります。カオスの高いドラゴンは、忍耐強いカメとはひと味違います。

---

ツール	機能
reroll_buddy	🎲 ルーレットを回します。ランダムなレア以上の結果と一致するソルトを総当たりで探し、バイナリにパッチを適用します。Claude を終了して再起動すると反映されます。
pet_buddy	🤚 相棒をつつきます。なでるたびに、愛情トークン獲得までの進捗が1～15%加算されます。100%になるとトークンを1個獲得でき、トークンは蓄積され、セッションをまたいで保持されます。次回の reroll_buddy でトークンを使うと、レア以上のレアリティが確定し、帽子の出現率が60%、色違いの出現率が20%になります。
buddy_talk	💬 相棒に何か話してもらいます。上位2つのステータスに応じて重み付けされた、ステータスベースの応答テンプレートを使います。ステータスを絞り込むためのコンテキストパラメーターは任意です。出力はそのまま表示されます。
view_buddy_dex	📖 これまでに引いたすべての種類を閲覧します。全種類集めましょう。
export_buddy_card	🖼️ 相棒カード全体を SVG 画像ファイルとしてエクスポートします。
export_buddy_sprite	🎨 相棒の ASCII スプライトだけを SVG 画像ファイルとしてエクスポートします。
deactivate_buddy_interact	🔕 相棒の観察モードをオフにします。相棒は見守るのをやめます。（相棒の観察はデフォルトで常にオンです。）

ステータス別の性格ツール

組み込みツールは20個です。 一度に表示されるのは2個だけです。相棒の生の数値が高い上位2つのステータスから、ランダムに1つずつ選ばれます。残りの18個は非表示になります。表示される2つのツールは、ロールごとに固定されます。リロールするまで変わりません。相棒ごとに表示される組み合わせは異なります。

---

トラブルシューティング

リロールしても相棒が変わらない

通常の流れ（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 をフォークし、拡張しました。